GET
Account statement for a period

Authorizations

Authorization
string
header
required

Account-bound token for the public API resource.

Scopes

account:read

Read account data.

Headers

Tuyo-API-Version
string
required

Required dated public API contract.

Allowed value: "2026-10-20"
Tuyo-Request-Reason
string

Optional, percent-encoded short explanation of why the request is made (e.g. the end-user goal relayed by an AI agent). Stored for audit; truncated to 2048 characters after decoding.

Query Parameters

from
required

Start of the period, inclusive. A date-time is used exactly; a calendar date means its start.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
to

End of the period, exclusive. A date-time is used exactly and must not be in the future; a calendar date means its end, clipped to now for today. Defaults to now.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
timezone
string
default:UTC

Only used to expand calendar dates.

first
integer
default:250

Maximum transactions to list in this page, oldest first. Follow transactionsPage.endCursor for the rest; boundaries, positions and summary always cover the whole period.

Required range: 1 <= x <= 500
after
string

Opaque transactionsPage.endCursor from a previous request of the same period.

Required string length: 1 - 4096
detail
enum<string>
default:full

summary returns the period, boundaries, positions, summary and meta with an empty transactions list and catalog; full also lists transactions.

Available options:
full,
summary

Response

Successful response.

period
object
required
opening
any
required
closing
any
required
summary
object
required

Account-level totals. Conversions and vault moves reallocate between positions and are not counted as inflow or outflow; their net shows as executionEffectValue. closingValue = openingValue + inflowValue - outflowValue + yieldValue + priceChangeValue + executionEffectValue + unexplainedValue.

positions
object[]
required
transactions
any[]
required

The period transactions, oldest first, paged by first and after; empty when detail=summary. Whatever its status, plus earlier card purchases with allocation rows recorded inside it; each with legs (include=legs). Legs are present only where money moved; card legs are limited to rows recorded in the period. Token and vault fields inside entries are catalog references.

transactionsPage
any
required

Pagination for transactions only; boundaries, positions, summary and meta always cover the whole period.

catalog
object
required

Token and vault metadata for the references inside transactions, carried once per response.

meta
object
required