Endpoints

Api Spec

get

Responses

200

Successful Response

application/json

Responseany

get

HTTPcURLJavaScriptPython

GET /ton-rewards/spec.json HTTP/1.1
Host: 
Accept: */*

200

Successful Response

No content

Docs

get

Responses

200

Successful Response

application/json

Responseany

get

HTTPcURLJavaScriptPython

GET /ton-rewards/docs HTTP/1.1
Host: 
Accept: */*

200

Successful Response

No content

Get Nominator Rewards

get

Authorizations

Query parameters

since_inclusiveany ofOptional

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

string · date-timeOptional

or

nullOptional

to_exclusiveany ofOptional

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

string · date-timeOptional

or

nullOptional

nominator_addressstringRequired

User friendly nominator address, EQ...

Responses

200

Successful Response

application/json

401

Unrecognized or missing API key

404

Data not found for the filter

422

Validation Error

application/json

get

HTTPcURLJavaScriptPython

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

{
  "nominator_address": "text",
  "entries": [
    {
      "pool_address": "text",
      "seqno": 1,
      "timestamp": 1,
      "snapshot_time": "2025-08-26T16:53:32.606Z",
      "denom": "text",
      "stake_amount": "text",
      "rewards": "text",
      "arr": "text",
      "new_stake": "text",
      "withdrawal": "text"
    }
  ]
}

Get Pool Rewards

get

Authorizations

Query parameters

since_inclusiveany ofOptional

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

string · date-timeOptional

or

nullOptional

to_exclusiveany ofOptional

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

string · date-timeOptional

or

nullOptional

pool_addressstringRequired

Pool address

Responses

200

Successful Response

application/json

401

Unrecognized or missing API key

404

Data not found for the filter

422

Validation Error

application/json

get

HTTPcURLJavaScriptPython

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

{
  "pool_address": "text",
  "entries": [
    {
      "seqno": 1,
      "timestamp": 1,
      "snapshot_time": "2025-08-26T16:53:32.606Z",
      "denom": "text",
      "stake_amount": "text",
      "rewards": "text",
      "commissions": "text",
      "c1_commissions": "text",
      "neto_nominator_arr": "text",
      "pool_arr": "text",
      "nominators_count": 1
    }
  ]
}