/{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.

Follow nextPageUrl or pass nextCursor as cursor to retrieve the next page.

A party with no rewards in the window receives HTTP 200 with an empty rewards array and zero totals.

Path Params

chain

string

required

Defaults to canton

Canton chain name. Use a name returned by GET /chains.

party

string

required

Defaults to noves-validator-1::1220dd5cc6e969cd7d7c11e339fbd07fab5f6fa1f999dc09339228d17299d9d68941

Full Canton party ID whose rewards are requested.

Query Params

startTimestamp

int64

Defaults to 1785263213

Start of the requested time window, as Unix seconds. Optional.

endTimestamp

int64

Defaults to 1787855213

End of the requested time window, as Unix seconds. Optional.

rewardType

string

Defaults to all

Reward type to include: validatorRewards, appRewards, svRewards, or all. Default is all.

pageSize

int32

1 to 500

Defaults to 100

Maximum number of reward transfers returned per page. Default is 100; maximum is 500.

sort

string

Defaults to desc

Sort order by effective time. Supported values are asc and desc. Default is desc.

cursor

string

Opaque cursor from the previous response's nextCursor. 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