Delegates
Delegates are regular wallets (addresses) which have registered themselves eligible to become a Delegate by a registration transaction. If a Delegate is amongst the top 51 highest voted (by staked ARK), it may run a forging Node, which produces a block once every 6.8 minutes, awarding the Delegate two ARK + the transaction fees.
Genesis Delegates are the initial, virtualized Delegates. They were not registered nor voted in, and in the ARK mainnet has been replaced by actual Delegates a long time ago.
Endpoints
List All Delegates
You can obtain all Delegates through this paginated API. Note that all registered Delegates are returned in this response, not just the top 51 forging Delegates.
If a Delegate Node is offline, it is still returned through this API; as the delegate resource is not concerned with the actual nodes, only with the on-chain registrations and wallets.
Endpoint
Query Parameters
| Name | Description | Required | Example |
|---|---|---|---|
| page |
The number of the page that will be returned.
|
No | 1 |
| limit |
The number of resources per page.
|
No | 100 |
| Name | page |
| Description |
The number of the page that will be returned.
|
| Required | No |
| Example | 1 |
| Name | limit |
| Description |
The number of resources per page.
|
| Required | No |
| Example | 100 |
Retrieve a Delegate
You can query for a specific delegate by username, address, and public key; thus the following queries will result in an identical response. Note that public keys are always known for delegates, as they have previously transmitted a registration transaction. This is not the case for regular wallets.
Endpoint
Path Parameters
| Name | Description | Required | Example |
|---|---|---|---|
| address |
The address of the delegate to be retrieved.
|
No | 1 |
| publicKey |
The public key of the delegate to be retrieved.
|
No | 1 |
| username |
The username of the delegate to be retrieved.
|
No | 1 |
| Name | address |
| Description |
The address of the delegate to be retrieved.
|
| Required | No |
| Example | 1 |
| Name | publicKey |
| Description |
The public key of the delegate to be retrieved.
|
| Required | No |
| Example | 1 |
| Name | username |
| Description |
The username of the delegate to be retrieved.
|
| Required | No |
| Example | 1 |