Blockdaemon Documentation
Solana Staking Reporting API
Delegator Endpoints
(GET) Get Status of Delegator
(POST) Get Status of Delegators
(GET) Get Stake & Rewards of Delegator
(POST) Get Stake & Rewards of Delegators
(POST) Get Historical Stake & Rewards of Delegator
(POST) Get Historical Stake & Rewards of Delegators
(GET) Verify Staking Activity of Delegator
(POST) Verify Staking Activity of Delegators
Validator Endpoints
(GET) Get Status of Validator
(POST) Get Status of Validators
(GET) Get Stake & Rewards of Validator
(POST) Get Stake & Rewards of Validators
(POST) Get Historical Stake & Rewards of Validator
(POST) Get Historical Stake & Rewards of Validators
(GET) Verify Staking Activity of Validator
(POST) Verify Staking Activity of Validators
Overview
With Blockdaemon Staking Reporting API, you can easily access staking information from multiple protocols for your financial data analysis needs.
The Solana Staking Reporting API endpoints listed in this section allow the retrieval of staking data in Solana Mainnet. You can get the current or historical stake & rewards allocated to given delegator and validator addresses and other data.
See also:
Supported Networks
Blockdaemon Staking Reporting API supports the following Solana networks:
- Solana Mainnet
- Solana Devnet
(GET) Get Status of Delegator
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/status/{address}
Returns the current status of a given delegator address.
Learn how to authorize your request: Authentication Guide
Path Parameters
It is required to specify a delegator address as the last path parameter, e.g.:
FctHvRvMv7Rgj2PuzCyPM1n5ZkcLgWLznnSs11rsmg5T
Example Queries
The query in this section provides a useful example for (GET) Get Status of Delegator.
To get the current status of a delegator in Solana Mainnet, use the following query:
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/status/FctHvRvMv7Rgj2PuzCyPM1n5ZkcLgWLznnSs11rsmg5T
Example Response
The following is a typical response from (GET) Get Status of Delegator:
{
"address": "71JuJDugtFBngxUkYc1v2g9MyvBkFGFTa17XCyVYMGLw",
"status": "active",
"commission": 6,
"activationDate": "2022-03-17"
}
(POST) Get Status of Delegators
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/status
Returns the current status of multiple given delegator addresses.
Learn how to authorize your request: Authentication Guide
Request Body
In the body of your request, specify an array of delegator addresses, for example:
{
"addresses": [
"FctHvRvMv7Rgj2PuzCyPM1n5ZkcLgWLznnSs11rsmg5T",
"GKF72rnrwwUtFewAnEtT1DRXwb1fakieMrN3u2D5Zrqv"
]
}
Example Response
The following is a typical response from (POST) Get Status of Delegators:
[
{
"address": "71JuJDugtFBngxUkYc1v2g9MyvBkFGFTa17XCyVYMGLw",
"status": "active",
"commission": 6,
"activationDate": "2022-03-17"
},
{ ...more items... }
]
(GET) Get Stake & Rewards of Delegator
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/rewards/{address}
Returns the current stake & rewards allocated to a given delegator address. Timestamps are given in UTC.
Learn how to authorize your request: Authentication Guide
Path Parameters
It is required to specify a delegator address as the last path parameter, e.g.:
FctHvRvMv7Rgj2PuzCyPM1n5ZkcLgWLznnSs11rsmg5T
Example Queries
The query in this section provides a useful example for (GET) Get Stake & Rewards of Delegator.
To get the current stake & rewards of a delegator in Solana Mainnet, use the following query:
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/rewards/FctHvRvMv7Rgj2PuzCyPM1n5ZkcLgWLznnSs11rsmg5T
Example Response
The following is a typical response from (GET) Get Stake & Rewards of Delegator:
{
"address": "71JuJDugtFBngxUkYc1v2g9MyvBkFGFTa17XCyVYMGLw",
"currency": "SOL",
"return": "853.053732078",
"timeStart": "2022-10-18T05:41:19Z",
"timeEnd": "2022-10-18T05:41:19Z",
"timeAggregation": "epoch",
"startingBalance": "1893300.002946607",
"metadata": {
"delegationAddress": "E4r87mnk6kkSaeNpHw2R4fSnzUR2ksajjZJDV5kpUpH2",
"epoch": 361
}
}
(POST) Get Stake & Rewards of Delegators
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/rewards
Returns the current stake & rewards allocated to multiple given delegator addresses. Timestamps are given in UTC.
Learn how to authorize your request: Authentication Guide
Request Body
In the body of your request, specify an array of delegator addresses, for example:
{
"addresses": [
"FctHvRvMv7Rgj2PuzCyPM1n5ZkcLgWLznnSs11rsmg5T",
"GKF72rnrwwUtFewAnEtT1DRXwb1fakieMrN3u2D5Zrqv"
]
}
Query Parameters
To aggregate rewards across addresses, use the following parameter:
- parameter:
aggregate
- value:
true
/false
(default)
Example Queries
The query in this section provides a useful example for (POST) Get Stake & Rewards of Delegators.
To get the aggregated rewards of multiple delegators in Solana Mainnet, use the following query:
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/rewards?aggregate=true
Example Response
The following is a typical response from (POST) Get Stake & Rewards of Delegators (non-aggregated):
[
{
"address": "71JuJDugtFBngxUkYc1v2g9MyvBkFGFTa17XCyVYMGLw",
"currency": "SOL",
"return": "853.053732078",
"timeStart": "2022-10-18T05:41:19Z",
"timeEnd": "2022-10-18T05:41:19Z",
"timeAggregation": "epoch",
"startingBalance": "1893300.002946607",
"metadata": {
"delegationAddress": "E4r87mnk6kkSaeNpHw2R4fSnzUR2ksajjZJDV5kpUpH2",
"epoch": 361
}
},
{ ...more items... }
]
(POST) Get Historical Stake & Rewards of Delegator
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/history/{address}
Returns the historical stake & rewards allocated to a given delegator address. Timestamps are given in UTC.
Learn how to authorize your request: Authentication Guide
Path Parameters
It is required to specify a delegator address as the last path parameter, e.g.:
FctHvRvMv7Rgj2PuzCyPM1n5ZkcLgWLznnSs11rsmg5T
Request Body
In the body of your request, specify a date range, for example:
{
"fromTime": 1662940800000,
"toTime": 1664755200000,
"timeUnit": "weekly"
}
In the fromTime
and toTime
fields, you should specify Unix timestamps in milliseconds (UTC time zone).
The timeUnit
parameter takes the following values:
Value | Response |
epoch |
All the rewards between given timestamps, aggregated by Solana epoch (2.5 days) |
day / daily |
All the rewards between given timestamps, aggregated by day |
week / weekly |
All the rewards between given timestamps, aggregated by week |
month / monthly |
All the rewards between given timestamps, aggregated by month |
Example Queries
The query in this section provides a useful example for (GET) Get Historical Stake & Rewards of Delegator.
To get historical stake & rewards of a delegator in Solana Mainnet, use the following query:
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/history/FctHvRvMv7Rgj2PuzCyPM1n5ZkcLgWLznnSs11rsmg5T
Example Response
The following is a typical response from (POST) Get Historical Stake & Rewards of Delegator:
[
{
"address": "71JuJDugtFBngxUkYc1v2g9MyvBkFGFTa17XCyVYMGLw",
"currency": "SOL",
"return": "2548.872023346",
"timeStart": "2022-09-26T00:00:00Z",
"timeEnd": "2022-10-02T23:59:59Z",
"timeAggregation": "weekly",
"startingBalance": "1888194.866998932",
"metadata": {
"delegationAddress": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
"epoch": 0
}
},
{ ...more items... }
]
(POST) Get Historical Stake & Rewards of Delegators
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/history
Returns the historical stake & rewards allocated to multiple given delegator addresses. Timestamps are given in UTC.
Learn how to authorize your request: Authentication Guide
Request Body
In the body of your request, specify a date range and an array of delegator addresses, for example:
{
"fromTime": 1662940800000,
"toTime": 1664755200000,
"timeUnit": "weekly",
"addresses": [
"FctHvRvMv7Rgj2PuzCyPM1n5ZkcLgWLznnSs11rsmg5T",
"GKF72rnrwwUtFewAnEtT1DRXwb1fakieMrN3u2D5Zrqv"
]
}
In the fromTime
and toTime
fields, you should specify Unix timestamps in milliseconds (UTC time zone).
The timeUnit
parameter takes the following values:
Value | Response |
epoch |
All the rewards between given timestamps, aggregated by Solana epoch (2.5 days) |
day / daily |
All the rewards between given timestamps, aggregated by day |
week / weekly |
All the rewards between given timestamps, aggregated by week |
month / monthly |
All the rewards between given timestamps, aggregated by month |
Query Parameters
To aggregate rewards across addresses, use the following parameter:
- parameter:
aggregate
- value:
true
/false
(default)
Example Queries
The query in this section provides a useful example for (POST) Get Historical Stake & Rewards of Delegators.
To get the aggregated historical rewards of multiple delegators in Solana Mainnet, use the following query:
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/history?aggregate=true
Example Response
The following is a typical response from (POST) Get Historical Stake & Rewards of Delegators (non-aggregated):
[
{
"address": "71JuJDugtFBngxUkYc1v2g9MyvBkFGFTa17XCyVYMGLw",
"currency": "SOL",
"return": "2548.872023346",
"timeStart": "2022-09-26T00:00:00Z",
"timeEnd": "2022-10-02T23:59:59Z",
"timeAggregation": "weekly",
"startingBalance": "1888194.866998932",
"metadata": {
"delegationAddress": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
"epoch": 0
}
},
{ ...more items... }
]
(GET) Verify Staking Activity of Delegator
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/active/{address}
Returns true if a given delegator address is active, false otherwise.
Learn how to authorize your request: Authentication Guide
Path Parameters
It is required to specify a delegator address as the last path parameter, e.g.:
FctHvRvMv7Rgj2PuzCyPM1n5ZkcLgWLznnSs11rsmg5T
Example Queries
The query in this section provides a useful example for (GET) Verify Staking Activity of Delegator.
To verify the staking activity of a delegator in Solana Mainnet, use the following query:
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/active/FctHvRvMv7Rgj2PuzCyPM1n5ZkcLgWLznnSs11rsmg5T
Example Response
The following is a typical response from (GET) Verify Staking Activity of Delegator:
{
"FctHvRvMv7Rgj2PuzCyPM1n5ZkcLgWLznnSs11rsmg5T": false
}
(POST) Verify Staking Activity of Delegators
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/active
Returns true if a given delegator address is active, false otherwise (for each address from a list).
Learn how to authorize your request: Authentication Guide
Request Body
In the body of your request, specify an array of delegator addresses, for example:
{
"addresses": [
"FctHvRvMv7Rgj2PuzCyPM1n5ZkcLgWLznnSs11rsmg5T",
"GKF72rnrwwUtFewAnEtT1DRXwb1fakieMrN3u2D5Zrqv"
]
}
Example Response
The following is a typical response from (GET) Verify Staking Activity of Delegators:
[
{
"FctHvRvMv7Rgj2PuzCyPM1n5ZkcLgWLznnSs11rsmg5T": false
},
{ ...more items... }
]
(GET) Get Status of Validator
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/status/{address}
Returns the current status of a given validator address.
Learn how to authorize your request: Authentication Guide
Path Parameters
It is required to specify a validator address as the last path parameter, e.g.:
7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy
Example Queries
The query in this section provides a useful example for (GET) Get Status of Validator.
To get the current status of a validator in Solana Mainnet, use the following query:
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/status/7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy
Example Response
The following is a typical response from (GET) Get Status of Validator:
{
"address": "FQwewNXahV7MiZcLpY6p1xhUs2acVGQ3U5Xxc7FzV571",
"status": "active",
"commission": 6,
"activationDate": "2022-03-17"
}
(POST) Get Status of Validators
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/status
Returns the current status of multiple given validator addresses.
Learn how to authorize your request: Authentication Guide
Request Body
In the body of your request, specify an array of validator addresses, for example:
{
"addresses": [
"7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy"
]
}
Example Response
The following is a typical response from (POST) Get Status of Validators:
[
{
"address": "FQwewNXahV7MiZcLpY6p1xhUs2acVGQ3U5Xxc7FzV571",
"status": "active",
"commission": 6,
"activationDate": "2022-03-17"
},
{ ...more items... }
]
(GET) Get Stake & Rewards of Validator
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/rewards/{address}
Returns the current stake & rewards allocated to a given validator address. Timestamps are given in UTC.
Learn how to authorize your request: Authentication Guide
Path Parameters
It is required to specify a validator address as the last path parameter, e.g.:
7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy
Example Queries
The query in this section provides a useful example for (GET) Get Stake & Rewards of Validator.
To get the current stake & rewards of a validator in Solana Mainnet, use the following query:
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/rewards/7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy
Example Response
The following is a typical response from (GET) Get Stake & Rewards of Validator:
{
"address": "FQwewNXahV7MiZcLpY6p1xhUs2acVGQ3U5Xxc7FzV571",
"currency": "SOL",
"return": "41.63547257",
"timeStart": "2022-10-18T05:41:19Z",
"timeEnd": "2022-10-18T05:41:19Z",
"timeAggregation": "epoch",
"startingBalance": "815.722834358",
"metadata": {
"delegationAddress": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
"epoch": 361
}
}
(POST) Get Stake & Rewards of Validators
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/rewards
Returns the current stake & rewards allocated to multiple given validator addresses. Timestamps are given in UTC.
Learn how to authorize your request: Authentication Guide
Request Body
In the body of your request, specify an array of validator addresses, for example:
{
"addresses": [
"7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy"
]
}
Query Parameters
To aggregate rewards across addresses, use the following parameter:
- parameter:
aggregate
- value:
true
/false
(default)
Example Queries
The query in this section provides a useful example for (POST) Get Stake & Rewards of Validators.
To get the aggregated rewards of multiple validators in Solana Mainnet, use the following query:
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/rewards?aggregate=true
Example Response
The following is a typical response from (POST) Get Stake & Rewards of Validators (non-aggregated):
[
{
"address": "FQwewNXahV7MiZcLpY6p1xhUs2acVGQ3U5Xxc7FzV571",
"currency": "SOL",
"return": "41.63547257",
"timeStart": "2022-10-18T05:41:19Z",
"timeEnd": "2022-10-18T05:41:19Z",
"timeAggregation": "epoch",
"startingBalance": "815.722834358",
"metadata": {
"delegationAddress": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
"epoch": 361
}
},
{ ...more items... }
]
(POST) Get Historical Stake & Rewards of Validator
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/history/{address}
Returns the historical stake & rewards allocated to a given validator address. Timestamps are given in UTC.
Learn how to authorize your request: Authentication Guide
Path Parameters
It is required to specify a validator address as the last path parameter, e.g.:
7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy
Request Body
In the body of your request, specify a date range, for example:
{
"fromTime": 1662940800000,
"toTime": 1664755200000,
"timeUnit": "weekly"
}
In the fromTime
and toTime
fields, you should specify Unix timestamps in milliseconds (UTC time zone).
The timeUnit
parameter takes the following values:
Value | Response |
epoch |
All the rewards between given timestamps, aggregated by Solana epoch (2.5 days) |
day / daily |
All the rewards between given timestamps, aggregated by day |
week / weekly |
All the rewards between given timestamps, aggregated by week |
month / monthly |
All the rewards between given timestamps, aggregated by month |
Example Queries
The query in this section provides a useful example for (GET) Get Historical Stake & Rewards of Validator.
To get historical stake & rewards of a validator in Solana Mainnet, use the following query:
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/history/7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy
Example Response
The following is a typical response from (POST) Get Historical Stake & Rewards of Validator:
[
{
"address": "FQwewNXahV7MiZcLpY6p1xhUs2acVGQ3U5Xxc7FzV571",
"currency": "SOL",
"return": "363.703853584",
"timeStart": "2022-09-26T00:00:00Z",
"timeEnd": "2022-10-02T23:59:59Z",
"timeAggregation": "weekly",
"startingBalance": "131.906637470",
"metadata": {
"delegationAddress": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
"epoch": "0"
}
},
{ ...more items... }
]
(POST) Get Historical Stake & Rewards of Validators
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/history
Returns the historical stake & rewards allocated to multiple given validator addresses. Timestamps are given in UTC.
Learn how to authorize your request: Authentication Guide
Request Body
In the body of your request, specify a date range and an array of validator addresses, for example:
{
"fromTime": 1662940800000,
"toTime": 1664755200000,
"timeUnit": "weekly",
"addresses": [
"7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy"
]
}
In the fromTime
and toTime
fields, you should specify Unix timestamps in milliseconds (UTC time zone).
The timeUnit
parameter takes the following values:
Value | Response |
epoch |
All the rewards between given timestamps, aggregated by Solana epoch (2.5 days) |
day / daily |
All the rewards between given timestamps, aggregated by day |
week / weekly |
All the rewards between given timestamps, aggregated by week |
month / monthly |
All the rewards between given timestamps, aggregated by month |
Query Parameters
To aggregate rewards across addresses, use the following parameter:
- parameter:
aggregate
- value:
true
/false
(default)
Example Queries
The query in this section provides a useful example for (POST) Get Historical Stake & Rewards of Validators.
To get the aggregated historical rewards of multiple validators in Solana Mainnet, use the following query:
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/history?aggregate=true
Example Response
The following is a typical response from (POST) Get Historical Stake & Rewards of Validators (non-aggregated):
[
{
"address": "FQwewNXahV7MiZcLpY6p1xhUs2acVGQ3U5Xxc7FzV571",
"currency": "SOL",
"return": "363.703853584",
"timeStart": "2022-09-26T00:00:00Z",
"timeEnd": "2022-10-02T23:59:59Z",
"timeAggregation": "weekly",
"startingBalance": "131.906637470",
"metadata": {
"delegationAddress": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
"epoch": "0"
}
},
{ ...more items... }
]
(GET) Verify Staking Activity of Validator
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/active/{address}
Returns true if a given validator address is active, false otherwise.
Learn how to authorize your request: Authentication Guide
Path Parameters
It is required to specify a validator address as the last path parameter, e.g.:
7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy
Example Queries
The query in this section provides a useful example for (GET) Verify Staking Activity of Validator.
To verify the staking activity of a validator in Solana Mainnet, use the following query:
https://svc.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/active/7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy
Example Response
The following is a typical response from (GET) Verify Staking Activity of Validator:
{
"7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy": false
}
(POST) Verify Staking Activity of Validators
https://svc.blockdaemon.comreporting/staking/v1/solana/mainnet/validator/active
Returns true if a given validator address is active, false otherwise (for each address from a list).
Learn how to authorize your request: Authentication Guide
Request Body
In the body of your request, specify an array of validator addresses, for example:
{
"addresses": [
"7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy"
]
}
Example Response
The following is a typical response from (GET) Verify Staking Activity of Validators:
[
{
"7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy": false
},
{ ...more items... }
]