Skip to main content
GET
Get a report

Authorizations

Authorization
string
header
required

JWT bearer token. Include as Authorization: Bearer <token>. See the Authentication guide for how to obtain one.

Headers

X-Trace-Version
string

API version. Omit to use the default version.

Example:

"1"

Query Parameters

periodStart
string<date-time>
required

Inclusive start of the reporting window. UTC timestamp in ISO 8601 format — the Z suffix is the timezone marker and is required (e.g., 2026-04-01T00:00:00Z). See the Date and time guide for the full format.

periodEnd
string<date-time>
required

Exclusive end of the reporting window. UTC timestamp in ISO 8601 format — the Z suffix is the timezone marker and is required (e.g., 2026-05-01T00:00:00Z). Must be strictly greater than periodStart. See the Date and time guide for the full format.

filters
string

Common filters for reports:

  • account.id[eq]=a1b2c3d4-5e6f-7890-abcd-ef1234567890 — single account
  • asset[eq]=USDT — keeps only the transactions in that asset, among the matched operations
  • tags.key[eq]=psp — operations carrying a tag with this key
  • tags.value[eq]=Amazon — operations carrying a tag with this value

asset takes only the eq operator, written as a condition of its own (joined to the others with ;). With another operator, or inside and(...) or or(...), the request is refused with 400 NON_FILTERABLE_ATTRIBUTE. Several asset[eq] conditions are combined with AND, so two different assets match nothing.

A tags.key filter and a tags.value filter are matched independently: used together, they can match different tags of the same operation.

See the Filtering guide for the LHS Brackets syntax and the full operator catalog.

Response

Aggregated report for the requested window.

Aggregated view of operations over a time window. Generated on each request — not persisted.

period
object
required

The reporting window. Boundary semantics are half-open — start inclusive, end exclusive.

totals
object[]
required

One entry per asset that had at least one counted transaction matching the filter in the period. Empty when nothing matched.