List reward transfers

Returns all reward transfers for a party, paginated, together with per-reward-type totals
across the window.

Filterable by reward type (validatorRewards, appRewards, svRewards).

If no date range is supplied, the API applies a default trailing 30-day window.

Note: For pagination, use the nextPageUrl link that will be returned as part of the output.

Unknown party: A well-formed party with no rewards in the window is not an error — the

API returns HTTP 200 with an empty rewards array and zeroed totals. A malformed party
id (not in participant::identifier form) returns HTTP 400.

Example response

{
  "party": "noves-validator-1::1220dd5c...",
  "period": { "startTime": "2026-05-30T14:06:24+00:00", "endTime": "2026-06-29T14:06:24+00:00" },
  "startTimestamp": "2026-05-30T14:06:24+00:00",
  "endTimestamp": "2026-06-29T14:06:24+00:00",
  "rewards": [
    {
      "updateId": "12206bb880e4...",
      "effectiveAt": "2026-06-26T03:03:10.712039+00:00",
      "type": "appRewards",
      "amount": "0.9748203563",
      "usdValue": "0.1438152472",
      "recipient": "noves-validator-1::1220dd5c..."
    }
  ],
  "hasMore": true,
  "nextCursor": "v2|2026-06-21T15:46:44.9354050+00:00|1220...",
  "nextPageUrl": "https://api.canton.noves.fi/canton/rewards/noves-validator-1::1220dd5c...?pageSize=100&sort=desc&cursor=...",
  "truncated": false,
  "maxRewards": null,
  "rewardsReturned": 100,
  "updatesScanned": 0,
  "totals": {
    "validatorRewards": { "count": 0, "totalAmount": "0", "totalUsdValue": null },
    "appRewards": { "count": 100, "totalAmount": "97.48", "totalUsdValue": "14.38" },
    "svRewards": { "count": 0, "totalAmount": "0", "totalUsdValue": null },
    "svIssuanceRewards": { "count": 0, "totalAmount": "0", "totalUsdValue": null }
  }
}
Path Params
string
required
Defaults to canton

Name of the chain.

string
required
Defaults to noves-validator-1::1220dd5cc6e969cd7d7c11e339fbd07fab5f6fa1f999dc09339228d17299d9d68941

The party identifier to fetch rewards for.

Query Params
int64
Defaults to 1780402842

Start timestamp to filter results by (Unix timestamp). Optional. If both time bounds are omitted, the API defaults to the last 30 days.

int64
Defaults to 1782994842

End timestamp to filter results by (Unix timestamp). Optional. If both time bounds are omitted, the API defaults to the current time and applies a trailing 30-day window.

string
Defaults to all

Filter by reward type: validatorRewards, appRewards, svRewards, or all (default). (svIssuanceRewards is aggregated in totals but is not a filterable value and is not returned as individual reward rows.)

int32
1 to 500
Defaults to 100

Number of items to return per page. Default is 100, max is 500.

string
Defaults to desc

Sort direction: 'asc' for ascending or 'desc' for descending. Default is 'desc'.

string

Pagination cursor from a previous response's nextCursor field. Optional.

Headers
string
required
Defaults to demokey

API Key to call the API. To generate one, visit https://noves.fi/pricing

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json