Get Started

The Blockdaemon Staking Reporting API allows you to access detailed staking information across various blockchain protocols, including validator status, rewards, and activity. Follow the steps below to get started with the Staking API today.

Step 1. Get an API Key

To access the Staking Services, you need an API key. Reach out to our Sales team today to request your key.

Step 2. Explore the Available Endpoints

The Staking API supports multiple blockchain networks. Here are the protocols you can interact with:

Ethereum

Cardano

NEAR

Polkadot

Polygon

Solana

Step 3. Authenticate Your API Requests

To authenticate your API requests, you have three methods to choose from:

• Method 1: Query Parameter

https://svc.blockdaemon.com/reporting/staking/v1/polkadot/mainnet/nominator/status/{address}?apiKey=YOUR_API_KEY

📘

Info:

If there are other query parameters, replace ? with &.

• Method 2: Bearer Token

curl --request GET 'https://svc.blockdaemon.com/reporting/staking/v1/polkadot/mainnet/nominator/status/{address}' \
--header 'Authorization: Bearer YOUR_API_KEY'

• Method 3: X-API-Key Header

curl --request GET 'https://svc.blockdaemon.com/reporting/staking/v1/polkadot/mainnet/nominator/status/{address}' \
--header 'X-API-Key: YOUR_API_KEY' 

Step 4. Test the API

To test the API, send a simple GET request to one of the endpoints.

For example, you can send a GET request to check the protocol rewards processing health. Ensure to replace YOUR_API_KEY with your actual API key.

curl --request GET \
     --url https://svc.blockdaemon.com/reporting/staking/v2/ethereum/mainnet/health \
     --header 'X-API-Key: YOUR_API_KEY' \
     --header 'accept: application/json'

The response will be returned in JSON format.

{
  "status": "OPTIMAL",
  "timestamp": 1737568917,
  "metadata": {
    "lastProcessedEpoch": "340478",
    "chainEpoch": "340479"
  }
}

👋 Need Help?

Contact us through email or our support page for any issues, bugs, or assistance you may need.