/{chain}/rewards/earnings/timeSeries

get

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

Returns historical Canton Coin earned per unit of Featured App marker weight. Choose either a timestamp window grouped into UTC hour/day buckets or an inclusive mining round range with one item per available completed round.

startTimestamp is inclusive and endTimestamp is exclusive. The maximum window is 7 days for hour and 30 days for day.

Timestamp buckets include only completed earning rounds. Buckets without completed rounds contain zero values.

Path Params

chain

string

required

Defaults to canton

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

Query Params

startTimestamp

int64

-62135596800 to 253402300799

Inclusive start of the timestamp window, as Unix seconds. Required with endTimestamp in timestamp mode.

endTimestamp

int64

-62135596800 to 253402300799

Exclusive end of the timestamp window, as Unix seconds. Required with startTimestamp in timestamp mode.

interval

string

^(?i:hour|day|round)$

Timestamp bucket size: hour or day; defaults to hour in timestamp mode. Use round or omit it in round mode.

fromRound

int64

≥ 0

First mining round to include. Supply with toRound instead of timestamps.

toRound

int64

≥ 0

Last mining round to include. Supply with fromRound instead of timestamps. At most 500 rounds.

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