/{chain}/rewards/{party}

get

https://api.canton.noves.fi/{chain}/rewards/{party}

Returns a paginated list of reward transfers for a party, together with totals by reward type across the requested window.

Filter by validatorRewards, appRewards, or svRewards.

If both startTimestamp and endTimestamp are omitted, the API applies a trailing 30-day window by default.

Note: For pagination, use the nextPageUrl link that will be returned as part of the output, or use the cursor parameter with the value from nextCursor in the previous response.

A party with no rewards in the window will return a HTTP 200 response with an empty rewards array and zeroed totals.

Path Params

chain

string

required

Defaults to canton

Name of the chain.

party

string

required

Defaults to noves-validator-1::1220dd5cc6e969cd7d7c11e339fbd07fab5f6fa1f999dc09339228d17299d9d68941

The party identifier to fetch rewards for.

Query Params

startTimestamp

int64

Defaults to 1782480066

Start timestamp to filter results by (Unix timestamp). Optional.

endTimestamp

int64

Defaults to 1785072066

End timestamp to filter results by (Unix timestamp). Optional.

rewardType

string

Defaults to all

Reward type to return: validatorRewards, appRewards, svRewards, or all (default).

pageSize

int32

1 to 500

Defaults to 100

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

sort

string

Defaults to desc

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

cursor

string

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

Headers

apiKey

string

required

Defaults to demokey

API Key for Canton API. To generate an API Key, visit https://app.noves.fi

Responses

200Success

400Bad Request