Rewards

A series of endpoints that drill down on rewards related metrics for validators.

Validator Rewards

Get validator rewards metrics

This endpoint returns a bunch of useful information about the historical rewards earned by a single validator.

GET/v1/solana/validators/{validator_id}/rewards

Path parameters

validator_id*Validator Id

Query parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/solana/validators/{validator_id}/rewards', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "voteAccount": "voteAccount",
      "from_": "2024-12-14",
      "stakeRewards": 25000.1,
      "blockRewards": 250.2,
      "rentRewards": 50.01,
      "voteRewards": 2500.1,
      "mevClaimed": 110.1,
      "mevTips": 1100.1
    }
  ]
}

You can query this endpoint by using the vote_accountaddress of a validator as the validator_id. The granularity of results can either be daily or around 20 minute intervals (3,000 slots).

Earliest data available is from April 1, 2024.

Delegator Rewards

By Stake Account

Get stake account rewards metrics

This endpoint returns a bunch of useful information about the historical rewards earned by a single stake account.

GET/v1/solana/delegators/stakeAccounts/{stake_account}/rewards

Path parameters

stake_account*Stake Account

Query parameters

Response

200400

Successful Response

Body

application/json

any

Request

JavaScriptCurlPython

const response = await fetch('/v1/solana/delegators/stakeAccounts/{stake_account}/rewards', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

400

{
  "detail": [
    {
      "loc": [
        "text"
      ],
      "msg": "text",
      "type": "text"
    }
  ]
}

By Stake Authority

Get stake authority rewards metrics

This endpoint returns a bunch of useful information about the historical rewards earned by stake authority based on its aggregated stake accounts.

GET/v1/solana/delegators/stakeAuthorities/{stake_authority}/rewards

Path parameters

stake_authority*Stake Authority

Query parameters

Response

200400

Successful Response

Body

application/json

any

Request

JavaScriptCurlPython

const response = await fetch('/v1/solana/delegators/stakeAuthorities/{stake_authority}/rewards', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

400

{
  "detail": [
    {
      "loc": [
        "text"
      ],
      "msg": "text",
      "type": "text"
    }
  ]
}

These endpoints return information about the rewards received by a delegator (stake account or stake authority), including MEV rewards it has claimed, and commissions it has paid. The data can be broken down at a daily level.

Earliest data available is from April 1, 2024.