/{chain}/rewards/{party}/totals

get

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

Returns a party's reward totals over the requested time window for each reward type: validator (liveness) rewards, app rewards, Super Validator rewards, and Super Validator issuance rewards. Each total includes a count, a Canton Coin amount, and the USD value at the time each reward was earned.

If startTimestamp is omitted, the totals cover all history up to the end of the window. The window used is returned in period.

Totals for very large windows can be capped. When that happens, truncated is true, maxRewards is the number of rewards included, and the totals are a lower bound.

Use GET /{chain}/rewards/{party} for the individual reward transfers.

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 reward totals are requested.

Query Params

startTimestamp

int64

-62135596800 to 253402300799

Defaults to 1790455982

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

endTimestamp

int64

-62135596800 to 253402300799

Defaults to 1793047982

End of the requested time window (exclusive), as Unix seconds. Optional; defaults to now.

rewardType

string

enum

Defaults to all

Reward type to include: validatorRewards, appRewards, svRewards, or all. Default is all. Super Validator issuance rewards are included only with all.

Allowed:

Headers

apiKey

string

required

Defaults to demokey

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

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Success

401Invalid API key. ProblemDetails code: invalidApiKey. The API credential is missing, malformed, oversized, duplicated, or invalid.

403Feature not authorized. ProblemDetails code: featureNotAuthorized. The validated identity is not authorized for canton.analytics.

404The data source has no record of the requested party or resource. Its response is returned unchanged as application/json.

502The data source answered that it could not reach what it needed. Its response is returned unchanged as application/json, so the body is the data source's own and carries no ProblemDetails code. The request can be retried.

504The upstream service timed out. ProblemDetails code: upstreamTimeout. The data source did not answer within the 30 seconds this read allows. The request can be retried.