Solana API v2 Overview

Enhanced version of Solana API.

Overview

The Solana Staking Reporting API v2 expands its feature set to include:

  • Timezone-based reporting capabilities.
  • Improved handling of validator and delegator statuses.

👍

Info:

For more information, please refer to the Migration Guide.

➡️ Get the Rewards

Endpoints

Endpoint
Get a Stream of Rewards - POST /{type}/rewards
Get a Stream of Rewards for a Single Address - GET /{type}/rewards/{address}

Sample Object

The response below is returned from the validator request at the Get a stream of rewards for a single address endpoint.

{
  "address": "FQwewNXahV7MiZcLpY6p1xhUs2acVGQ3U5Xxc7FzV571",
  "denomination": "lamports",
  "return": "283291849202",
  "startTime": 1709251200,
  "endTime": 1711929600,
  "period": "raw",
  "startBalance": "124222",
  "metadata": {
    "fee": "532626257312",
    "epoch": "1",
    "identity": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
    "slot": "251296884",
    "voteKey": "FQwewNXahV7MiZcLpY6p1xhUs2acVGQ3U5Xxc7FzV571",
    "voting": "532626257312",
    "stake": "532626257312",
    "mev": "532626257312",
    "staking": "532626257312"
  }
}

➡️ Get a Status

Endpoints

Endpoint
Get a Stream of Statuses - POST /{type}/status
Get Status for an Address - GET /{type}/status/{address}

Sample Object

The response below is returned from the validator request at the Get a stream of statuses endpoint.

{
  "address": "FQwewNXahV7MiZcLpY6p1xhUs2acVGQ3U5Xxc7FzV571",
  "status": "ACTIVE",
  "metadata": {
    "authorisedWithdrawer": "GRKMJ1zE99jGh4SVA8HCwizVN9fL3yvr8JCCgvqUpbNv",
    "commission": "8",
    "identity": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
    "type": "validator",
    "voteKey": "FQwewNXahV7MiZcLpY6p1xhUs2acVGQ3U5Xxc7FzV571"
  }
}

➡️ Get Health

Endpoints

Sample Object

The response below is returned from the Get the Protocol Rewards Processing Health endpoint.

{
  "status": "OPTIMAL",
  "timestamp": 1717992354,
  "metadata": {
    "chainEpoch": "627",
    "chainSlot": "270943888",
    "lastProcessedInflationEpoch": "626",
    "lastProcessedMevEpoch": "626",
    "lastProcessedMevTxTimestamp": "1717894323",
    "lastProcessedSlot": "270943421",
    "lastProcessedStatusesEpoch": "627"
  }
}

👋 Need Help?

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