/{chain}/trafficPurchases/{party}

get

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

Returns a paginated list of synchronizer traffic purchases for a party. Each purchase includes the traffic bought, in bytes, and the Canton Coin burned to pay for it.

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

totalTrafficPurchased, totalUsdSpent, and totalPurchases cover the party's full purchase history, not only the requested window.

Pass nextCursor as cursor to retrieve the next page. Amounts are decimal strings.

Path Params

chain

string

required

Defaults to canton

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

party

string

required

Full Canton party ID whose traffic purchases are requested.

Query Params

startTimestamp

int64

-62135596800 to 253402300799

Start of the requested time window (inclusive), as Unix seconds. Optional; defaults to 30 days before the end.

endTimestamp

int64

-62135596800 to 253402300799

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

pageSize

int32

1 to 500

Defaults to 100

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

sort

string

^(?i:asc|desc)$

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

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.