Skip To Content

Blockdaemon Documentation

Solana Staking Reporting API

Overview

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: Solana API Developer Documentation


(GET) Get Status of Delegator

https://ubiquity.api.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://ubiquity.api.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://ubiquity.api.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://ubiquity.api.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/rewards/{address}

Returns the current stake & rewards allocated to 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 Stake & Rewards of Delegator.

To get the current stake & rewards of a delegator in Solana Mainnet, use the following query:

https://ubiquity.api.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",
    "delegationAddress": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
    "currency": "SOL",
    "yield": "854.031219894",
    "timePeriod": "343",
    "timeUnit": "epoch",
    "endingBalance": "1880507.511272357",
    "timestamp": "2022-08-29T09:13:09"
}

(POST) Get Stake & Rewards of Delegators

https://ubiquity.api.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/rewards/

Returns the current stake & rewards allocated to 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"
    ]
}

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://ubiquity.api.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:

[
    {
        "address": "71JuJDugtFBngxUkYc1v2g9MyvBkFGFTa17XCyVYMGLw",
        "delegationAddress": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
        "currency": "SOL",
        "yield": "860.561328078",
        "timePeriod": "342",
        "timeUnit": "epoch",
        "endingBalance": "1879653.480052463",
        "timestamp": "2022-08-26T15:29:12"
    },
    { ...more items... }
]

(POST) Get Historical Stake & Rewards of Delegator

https://ubiquity.api.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/history/{address}/

Returns the historical stake & rewards allocated to 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

Request Body

In the body of your request, specify a date range, for example:

{
    "fromTime": 1656669919000,
    "toTime": 1661940388000,
    "timeUnit": "epoch"
}

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://ubiquity.api.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",
        "delegationAddress": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
        "currency": "SOL",
        "yield": "881.281304395",
        "timePeriod": "340",
        "timeUnit": "epoch",
        "endingBalance": "1877936.912876794",
        "timestamp": "2022-08-20T19:29"
    },
    { ...more items... }
]

(POST) Get Historical Stake & Rewards of Delegators

https://ubiquity.api.blockdaemon.com/reporting/staking/v1/solana/mainnet/delegator/history

Returns the historical stake & rewards allocated to multiple given delegator addresses.

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": 1656669919000,
    "toTime": 1661940388000,
    "timeUnit": "epoch",
    "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://ubiquity.api.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:

[
    {
        "address": "71JuJDugtFBngxUkYc1v2g9MyvBkFGFTa17XCyVYMGLw",
        "delegationAddress": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
        "currency": "SOL",
        "yield": "881.281304395",
        "timePeriod": "340",
        "timeUnit": "epoch",
        "endingBalance": "1877936.912876794",
        "timestamp": "2022-08-20T19:29"
    },
    { ...more items... }
]

(GET) Verify Staking Activity of Delegator

https://ubiquity.api.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://ubiquity.api.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://ubiquity.api.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://ubiquity.api.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://ubiquity.api.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://ubiquity.api.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://ubiquity.api.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/rewards/{address}

Returns the current stake & rewards allocated to 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 Stake & Rewards of Validator.

To get the current stake & rewards of a validator in Solana Mainnet, use the following query:

https://ubiquity.api.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",
    "delegationAddress": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
    "currency": "SOL",
    "yield": "97.101383258",
    "timePeriod": "343",
    "timeUnit": "epoch",
    "endingBalance": "1768.106448705",
    "timestamp": "2022-08-29T09:13:09"
}

(POST) Get Stake & Rewards of Validators

https://ubiquity.api.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/rewards/

Returns the current stake & rewards allocated to 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"
    ]
}

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://ubiquity.api.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:

[
    {
        "address": "FQwewNXahV7MiZcLpY6p1xhUs2acVGQ3U5Xxc7FzV571",
        "delegationAddress": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
        "currency": "SOL",
        "yield": "97.101383258",
        "timePeriod": "343",
        "timeUnit": "epoch",
        "endingBalance": "1768.106448705",
        "timestamp": "2022-08-29T09:13:09"
    },
    { ...more items... }
]

(POST) Get Historical Stake & Rewards of Validator

https://ubiquity.api.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/history/{address}/

Returns the historical stake & rewards allocated to 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

Request Body

In the body of your request, specify a date range, for example:

{
    "fromTime": 1656669919000,
    "toTime": 1661940388000,
    "timeUnit": "epoch"
}

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://ubiquity.api.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",
        "delegationAddress": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
        "currency": "SOL",
        "yield": "100.183694477",
        "timePeriod": "340",
        "timeUnit": "epoch",
        "endingBalance": "1475.850316405",
        "timestamp": "2022-08-20T19:29"
    },
    { ...more items... }
]

(POST) Get Historical Stake & Rewards of Validators

https://ubiquity.api.blockdaemon.com/reporting/staking/v1/solana/mainnet/validator/history

Returns the historical stake & rewards allocated to multiple given validator addresses.

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": 1656669919000,
    "toTime": 1661940388000,
    "timeUnit": "epoch",
    "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://ubiquity.api.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:

[
    {
        "address": "FQwewNXahV7MiZcLpY6p1xhUs2acVGQ3U5Xxc7FzV571",
        "delegationAddress": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
        "currency": "SOL",
        "yield": "100.183694477",
        "timePeriod": "340",
        "timeUnit": "epoch",
        "endingBalance": "1475.850316405",
        "timestamp": "2022-08-20T19:29"
    },
    { ...more items... }
]

(GET) Verify Staking Activity of Validator

https://ubiquity.api.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://ubiquity.api.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://ubiquity.api.blockdaemon.com/reporting/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... }
]

We don't support Internet Explorer

Please use Chrome, Safari, Firefox, or Edge to view this site.