RSS3 Documentation

Retrieve Node rewards by epoch

Retrieve the rewards of a specific Node by epoch. This endpoint allows filtering by cursor and limit for pagination.

GET
/nta/epochs/{address}/rewards
/nta/epochs/{address}/rewards

Path Parameters

address
Required
string

The address of the Node to retrieve.

Query Parameters

cursorstring

Specify the cursor used for pagination. This helps in retrieving the next set of results in a paginated response.

limitinteger

Limit the number of results

Default: 50
curl -X GET "https://gi.rss3.io/nta/epochs/string/rewards?cursor=string&limit=50"

A successful response containing the rewards of the specified Node by epoch. Each entry in the data array includes detailed information about the epoch.

{
  "data": [
    {
      "id": 130,
      "start_timestamp": 1718589689,
      "end_timestamp": 1718654555,
      "total_operation_rewards": "0",
      "total_staking_rewards": "61084916609459274004676",
      "total_request_counts": "40",
      "total_reward_items": 65,
      "distributions": [
        {
          "id": 130,
          "start_timestamp": 1718589689,
          "end_timestamp": 1718654555,
          "transaction": {
            "hash": "0xe804d536d996d49b0ec8627361bc642f92d440e6b519e6faab0944f70bf05fd2",
            "index": 1
          },
          "block": {
            "hash": "0xd9e2a4df54a385507a302ec3c62d3b3833ce8ed80242694d79cfa5b034840379",
            "number": 4398018,
            "timestamp": 1718654555
          },
          "total_operation_rewards": "0",
          "total_staking_rewards": "61084916609459274004676",
          "total_request_counts": "40",
          "total_rewarded_nodes": 65,
          "rewarded_nodes": [
            {
              "epoch_id": 130,
              "index": 48,
              "transaction_hash": "0xe804d536d996d49b0ec8627361bc642f92d440e6b519e6faab0944f70bf05fd2",
              "node_address": "0x69982e017acc0fde3d1542205089a8d3eafcd1b7",
              "operation_rewards": "0",
              "staking_rewards": "18250125229171339678441",
              "tax_collected": "1270138765073564056898",
              "request_count": "0"
            }
          ]
        }
      ]
    }
  ],
  "cursor": "string"
}