Delegates
Delegates are regular wallets (addresses) which have registered themselves eligible to become a Delegate by a registration transaction. If a Delegate is among the top 51 highest voted (by staked ARK), it may run a forging Node, which produces a single block per round, awarding the Delegate 2 ARK + any transaction fees included in that block.
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
GET
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 |
| offset |
The number of resources to be skipped.
|
No | |
| orderBy |
The column and order by which the resources will be sorted.
|
No | |
| username |
The username of the delegate to be retrieved.
|
No | |
| address |
The address of the delegate to be retrieved.
|
No | |
| publicKey |
The public key of the delegate to be retrieved.
|
No | |
| votes |
The votes of the delegate to be retrieved.
|
No | |
| votes.from |
The minimum votes of the delegates to be retrieved.
|
No | |
| votes.to |
The maximum votes of the delegates to be retrieved.
|
No | |
| isResigned |
The resignation status of the delegate to be retrieved.
|
No | |
| blocks.produced |
The number of produced blocks of the delegate to be retrieved.
|
No | |
| blocks.produced.from |
The minimum number of produced blocks of the delegate to be retrieved.
|
No | |
| blocks.produced.to |
The minimum number of produced blocks of the delegate to be retrieved.
|
No | |
| blocks.last.id |
The last produced block id of the delegate to be retrieved.
|
No | |
| blocks.last.height |
The last produced block height of the delegate to be retrieved.
|
No | |
| blocks.last.timestamp.epoch |
The last produced block epoch timestamp of the delegate to be retrieved.
|
No | |
| blocks.last.timestamp.epoch.from |
The minimum last produced block epoch timestamp of the delegate to be retrieved.
|
No | |
| blocks.last.timestamp.epoch.to |
The maximum last produced block epoch timestamp of the delegate to be retrieved.
|
No | |
| blocks.last.timestamp.unix |
The last produced block unix timestamp of the delegate to be retrieved.
|
No | |
| blocks.last.timestamp.unix.from |
The minimum last produced unix epoch timestamp of the delegate to be retrieved.
|
No | |
| blocks.last.timestamp.unix.to |
The maximum last produced unix epoch timestamp of the delegate to be retrieved.
|
No | |
| blocks.last.timestamp.human |
The last produced block timestamp of the delegate to be retrieved.
|
No | |
| production.approval |
The production approval rate of the delegate to be retrieved.
|
No | |
| production.approval.from |
The minimum production approval rate of the delegate to be retrieved.
|
No | |
| production.approval.to |
The maximum production approval rate of the delegate to be retrieved.
|
No | |
| forged.fess |
The forged fees of the delegate to be retrieved.
|
No | |
| forged.fess.from |
The minimum forged fees of the delegate to be retrieved.
|
No | |
| forged.fess.to |
The maximum forged fees of the delegate to be retrieved.
|
No | |
| forged.rewards |
The forged rewards of the delegate to be retrieved.
|
No | |
| forged.rewards.from |
The minimum forged rewards of the delegate to be retrieved.
|
No | |
| forged.rewards.to |
The maximum forged rewards of the delegate to be retrieved.
|
No | |
| forged.total |
The forged fees and rewards of the delegate to be retrieved.
|
No | |
| forged.total.from |
The minimum forged fees and rewards of the delegate to be retrieved.
|
No | |
| forged.total.to |
The maximum forged fees and rewards of the delegate to be retrieved.
|
No |
| 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 |
| Name | offset |
| Description |
The number of resources to be skipped.
|
| Required | No |
| Example |
| Name | orderBy |
| Description |
The column and order by which the resources will be sorted.
|
| Required | No |
| Example |
| Name | username |
| Description |
The username of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | address |
| Description |
The address of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | publicKey |
| Description |
The public key of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | votes |
| Description |
The votes of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | votes.from |
| Description |
The minimum votes of the delegates to be retrieved.
|
| Required | No |
| Example |
| Name | votes.to |
| Description |
The maximum votes of the delegates to be retrieved.
|
| Required | No |
| Example |
| Name | isResigned |
| Description |
The resignation status of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | blocks.produced |
| Description |
The number of produced blocks of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | blocks.produced.from |
| Description |
The minimum number of produced blocks of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | blocks.produced.to |
| Description |
The minimum number of produced blocks of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | blocks.last.id |
| Description |
The last produced block id of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | blocks.last.height |
| Description |
The last produced block height of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | blocks.last.timestamp.epoch |
| Description |
The last produced block epoch timestamp of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | blocks.last.timestamp.epoch.from |
| Description |
The minimum last produced block epoch timestamp of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | blocks.last.timestamp.epoch.to |
| Description |
The maximum last produced block epoch timestamp of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | blocks.last.timestamp.unix |
| Description |
The last produced block unix timestamp of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | blocks.last.timestamp.unix.from |
| Description |
The minimum last produced unix epoch timestamp of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | blocks.last.timestamp.unix.to |
| Description |
The maximum last produced unix epoch timestamp of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | blocks.last.timestamp.human |
| Description |
The last produced block timestamp of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | production.approval |
| Description |
The production approval rate of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | production.approval.from |
| Description |
The minimum production approval rate of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | production.approval.to |
| Description |
The maximum production approval rate of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | forged.fess |
| Description |
The forged fees of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | forged.fess.from |
| Description |
The minimum forged fees of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | forged.fess.to |
| Description |
The maximum forged fees of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | forged.rewards |
| Description |
The forged rewards of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | forged.rewards.from |
| Description |
The minimum forged rewards of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | forged.rewards.to |
| Description |
The maximum forged rewards of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | forged.total |
| Description |
The forged fees and rewards of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | forged.total.from |
| Description |
The minimum forged fees and rewards of the delegate to be retrieved.
|
| Required | No |
| Example |
| Name | forged.total.to |
| Description |
The maximum forged fees and rewards of the delegate to be retrieved.
|
| Required | No |
| Example |
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
GET
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 |
List All Voters of a Delegate
Obtaining the voters of a Delegate is trivial as well. This endpoint returns active voters. To acquire historical voters, it is better to query the database directly.
Endpoint
GET
Path Parameters
| Name | Description | Required | Example |
|---|---|---|---|
| delegateAddress |
The address of the delegate to be retrieved.
|
No | 1 |
| delegatePublicKey |
The public key of the delegate to be retrieved.
|
No | 1 |
| delegateUsername |
The username of the delegate to be retrieved.
|
No | 1 |
| address |
The address of the voter to be retrieved.
|
No | |
| publicKey |
The public key of the voter to be retrieved.
|
No | |
| balance |
The balance of the voter to be retrieved.
|
No | 1 |
| balance.from |
The minimum balance of the voter to be retrieved.
|
No | 1 |
| balance.to |
The maximum balance of the voter to be retrieved.
|
No | 1 |
| nonce |
The nonce of the voter to be retrieved.
|
No | 1 |
| nonce.from |
The minimum nonce of the voter to be retrieved.
|
No | 1 |
| nonce.to |
The maximum nonce of the voter to be retrieved.
|
No | 1 |
| Name | delegateAddress |
| Description |
The address of the delegate to be retrieved.
|
| Required | No |
| Example | 1 |
| Name | delegatePublicKey |
| Description |
The public key of the delegate to be retrieved.
|
| Required | No |
| Example | 1 |
| Name | delegateUsername |
| Description |
The username of the delegate to be retrieved.
|
| Required | No |
| Example | 1 |
| Name | address |
| Description |
The address of the voter to be retrieved.
|
| Required | No |
| Example |
| Name | publicKey |
| Description |
The public key of the voter to be retrieved.
|
| Required | No |
| Example |
| Name | balance |
| Description |
The balance of the voter to be retrieved.
|
| Required | No |
| Example | 1 |
| Name | balance.from |
| Description |
The minimum balance of the voter to be retrieved.
|
| Required | No |
| Example | 1 |
| Name | balance.to |
| Description |
The maximum balance of the voter to be retrieved.
|
| Required | No |
| Example | 1 |
| Name | nonce |
| Description |
The nonce of the voter to be retrieved.
|
| Required | No |
| Example | 1 |
| Name | nonce.from |
| Description |
The minimum nonce of the voter to be retrieved.
|
| Required | No |
| Example | 1 |
| Name | nonce.to |
| Description |
The maximum nonce of the voter to be retrieved.
|
| Required | No |
| Example | 1 |
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 | |
| offset |
The number of resources to be skipped.
|
No | |
| orderBy |
The column and order by which the resources will be sorted.
|
No |
| 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 |
| Name | offset |
| Description |
The number of resources to be skipped.
|
| Required | No |
| Example |
| Name | orderBy |
| Description |
The column and order by which the resources will be sorted.
|
| Required | No |
| Example |
List All Blocks of a Delegate
The delegate resource allows you to obtain blocks from a specific Delegate. This is the equivalent of
searching for blocks
using the generatorPublicKey.
Endpoint
GET
Path Parameters
| Name | Description | Required | Example |
|---|---|---|---|
| delegateAddress |
The address of the delegate to be retrieved.
|
No | 1 |
| delegatePublicKey |
The public key of the delegate to be retrieved.
|
No | 1 |
| delegateUsername |
The username of the delegate to be retrieved.
|
No | 1 |
| Name | delegateAddress |
| Description |
The address of the delegate to be retrieved.
|
| Required | No |
| Example | 1 |
| Name | delegatePublicKey |
| Description |
The public key of the delegate to be retrieved.
|
| Required | No |
| Example | 1 |
| Name | delegateUsername |
| Description |
The username of the delegate to be retrieved.
|
| Required | No |
| Example | 1 |
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 |
| offset |
The number of resources to be skipped.
|
No | |
| transform |
The structure of response to be retrieved.
|
No | |
| orderBy |
The column and order by which the resources will be sorted.
|
No |
| 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 |
| Name | offset |
| Description |
The number of resources to be skipped.
|
| Required | No |
| Example |
| Name | transform |
| Description |
The structure of response to be retrieved.
|
| Required | No |
| Example |
| Name | orderBy |
| Description |
The column and order by which the resources will be sorted.
|
| Required | No |
| Example |
Last updated 2 months ago
Edit Page