NEAR

Onchain NEAR staking reward data at delegator and epoch grain.

The NEAR Rewards API returns onchain staking reward data for the NEAR network at delegator and epoch grain, net of pool commission. Rewards are keyed on the pool's ping time, the moment the pool contract distributed the reward to delegator shares.

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.

Delegator epoch rewards

Get Near Rewards Per Delegator Per Epoch

post

Authorizations

x-api-keystringRequired

Body

pool_addressstringRequired

Staking pool contract, e.g. bitwise_1.poolv1.near

delegator_addressesstring[] · min: 1Required

One or more delegator accounts in that pool

from_ping_timestring · date-timeRequired

Inclusive lower bound on ping_time (ISO-8601 with time zone, UTC)

to_ping_timestring · date-time · nullableOptional

Exclusive upper bound on ping_time

Responses

200

Successful Response

application/json

latest_pool_pingstring · nullableRequired

Newest published ping for this pool, ignoring the delegator and ping_time filters. Says how current our ingest is; says nothing about whether the entries above are complete.

401

Unrecognized or missing API key

403

API key lacks near access

404

Data not found for the filter

422

Validation Error

application/json

post/near-rewards/v1/delegator_epoch_rewards

POST /near-rewards/v1/delegator_epoch_rewards HTTP/1.1
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 140

{
  "pool_address": "text",
  "delegator_addresses": [
    "text"
  ],
  "from_ping_time": "2026-01-01T00:00:00.000Z",
  "to_ping_time": "2026-01-01T00:00:00.000Z"
}

{
  "entries": [
    {
      "pool_address": "text",
      "delegator_address": "text",
      "epoch_number": 1,
      "epoch_start_height": 1,
      "ping_time": "text",
      "reward_time": "text",
      "as_of_date_et": "text",
      "epochs_covered": 1,
      "denom": "text",
      "rewards": "text",
      "commission_amount": "text",
      "stake_amount": "text"
    }
  ],
  "latest_pool_ping": "text"
}