Rewards

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

These rewards currently only include Cosmos Hub rewards and excludes any rewards from Cosmos' Interchain Security model (i.e. rewards from other chains for the shared security provided by the hub).

The historical daily rewards are only available from November 22, 2024.

Validator Rewards

This validator rewards endpoint give you a breakdown of all rewards earned by a validator entity over a specified period of time.

Get validator rewards metrics

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

GET/v1/cosmos/validators/{validator_address}/rewards

Path parameters

validator_address*Validator Address

Query parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/cosmos/validators/{validator_address}/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": [
    {
      "day": "2024-11-25",
      "validator": "cosmosvaloper1hjadhj9nqzpye2vkmkz4thahhd0z8dh3udhq74",
      "validatorMoniker": "Atomic Nodes",
      "accountAddress": "cosmos1hjadhj9nqzpye2vkmkz4thahhd0z8dh3eer4jx",
      "fromBlockNumber": 23167650,
      "toBlockNumber": 23167800,
      "totalDelegationRewards": 9110.4079642566,
      "totalCommissionRewards": 1822.0815928513198,
      "commissionRate": 0.05
    }
  ]
}

Using this endpoint, you can query the historical daily rewards of a validator by their unique validator address. totalDelegationRewards are the Cosmos Hub rewards, denominated in ATOM, which delegators are entitled to receive from the validator they have staked to. This includes the rewards towards a validator if they have self-staked/self-bonded. The rewards from the commission a validator charges are given by the totalCommissionRewards.

Network Rewards

This network rewards endpoint gives you a breakdown of all rewards earned by bonded validators over a specified period of time.

Get network rewards metrics

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

GET/v1/cosmos/network/rewards

Query parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/cosmos/network/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": [
    {
      "day": "2024-11-25",
      "fromBlockNumber": 23167650,
      "toBlockNumber": 23167800,
      "totalBondedValidators": 200,
      "totalDelegationRewards": 9110.407,
      "totalCommissionRewards": 1822.081,
      "avgCommissionRate": 0.105
    }
  ]
}

Using this endpoint, you can query the total historical daily rewards at the network-level for the specific day. totalDelegationRewards are the Cosmos Hub rewards, denominated in ATOM, which delegators are entitled to receive from the validators they have staked to. This includes the rewards towards validators that have self-staked/self-bonded. The rewards from the commissions validators charge are given by the totalCommissionRewards.