TON

Onchain TON Pool staking reward data, at pool and nominator level.

The TON Pool Rewards API returns onchain staking reward data for TON pools. It reports rewards at the pool level and for individual nominators.

Authenticate with the X-API-KEY header; see Rewards Dashboard API Keys to obtain a key. Historical backfill is available from the date of first stake.

Nominator rewards

Get Nominator Rewards

get

Authorizations

x-api-keystringRequired

Query parameters

since_inclusivestring · date-time · nullableOptional

Timestamp (ISO-8601 with time zone). From the beginning if not set

to_exclusivestring · date-time · nullableOptional

Timestamp (ISO-8601 with time zone). Up to most recent entry if not set

nominator_addressstringRequired

User friendly nominator address, EQ...

Responses

200

Successful Response

application/json

nominator_addressstringRequired

User friendly nominator address

401

Unrecognized or missing API key

404

Data not found for the filter

422

Validation Error

application/json

get/ton-rewards/v1/nominator_rewards

GET /ton-rewards/v1/nominator_rewards?nominator_address=text HTTP/1.1
x-api-key: YOUR_API_KEY
Accept: */*

{
  "nominator_address": "text",
  "entries": [
    {
      "pool_address": "text",
      "seqno": 1,
      "timestamp": 1,
      "snapshot_time": "2026-01-01T00:00:00.000Z",
      "denom": "text",
      "stake_amount": "text",
      "rewards": "text",
      "arr": "text",
      "new_stake": "text",
      "withdrawal": "text"
    }
  ]
}

Pool rewards

Get Pool Rewards

get

Authorizations

x-api-keystringRequired

Query parameters

since_inclusivestring · date-time · nullableOptional

Timestamp (ISO-8601 with time zone). From the beginning if not set

to_exclusivestring · date-time · nullableOptional

Timestamp (ISO-8601 with time zone). Up to most recent entry if not set

pool_addressstringRequired

Pool address

Responses

200

Successful Response

application/json

pool_addressstringRequired

Pool address

401

Unrecognized or missing API key

404

Data not found for the filter

422

Validation Error

application/json

get/ton-rewards/v1/pool_rewards

GET /ton-rewards/v1/pool_rewards?pool_address=text HTTP/1.1
x-api-key: YOUR_API_KEY
Accept: */*

{
  "pool_address": "text",
  "entries": [
    {
      "seqno": 1,
      "timestamp": 1,
      "snapshot_time": "2026-01-01T00:00:00.000Z",
      "denom": "text",
      "stake_amount": "text",
      "rewards": "text",
      "commissions": "text",
      "c1_commissions": "text",
      "neto_nominator_arr": "text",
      "pool_arr": "text",
      "nominators_count": 1
    }
  ]
}