v2

latestOpenAPI 3.1.02026-08-0513206146.6 KB
Transactions

List Transactions

<Callout intent="warning"> The endpoints exposed here are currently in **Beta**! As we continue to build our initial offering, these endpoints may implement breaking changes. Be sure to check back for our change log regularly as a precaution. </Callout>

List your settled transactions, newest first, with cursor pagination. Each entry summarizes the source and recipient, the per-currency totals each side moved, and the type (mint, redeem, bridge, reward, return). type and status are open enums; tolerate unknown values. Fetch one transaction's legs with Get a Transaction by ID.

Narrow the list with type, sourceChain, recipientChain, isInstantSettlement, and an initiatedAt range; every filter you send must hold (see Filtering list endpoints). The chain filters match the source and recipient the response reports, so a mint funded by wire matches on recipientChain only.

get/v0/transactions

Query parameters

cursorstring

Opaque pagination cursor. Pass the nextCursor from the previous response; omit to fetch the first page.

limitinteger

Page size. Defaults to 50; capped at 200.

initiatedAt.gtstring date-time

Exclusive lower bound on the transaction's initiation time, as an ISO-8601 timestamp.

initiatedAt.gtestring date-time

Inclusive lower bound on the transaction's initiation time, as an ISO-8601 timestamp.

initiatedAt.ltstring date-time

Exclusive upper bound on the transaction's initiation time, as an ISO-8601 timestamp. Pairs with initiatedAt.gte to select a period without depending on its last instant.

initiatedAt.ltestring date-time

Inclusive upper bound on the transaction's initiation time, as an ISO-8601 timestamp.

isInstantSettlement'true' | 'false'

Return only transactions whose settlement path matches. true is the instant-settlement path; false is standard settlement, which includes movement types that have no settlement path of their own, such as rewards and returns.

Return only transactions whose settlement path matches. true is the instant-settlement path; false is standard settlement, which includes movement types that have no settlement path of their own, such as rewards and returns.

recipientChainV0TransactionsGetParametersRecipientChainSchemaItems[]

Return only transactions whose recipient received value on these networks, comma-separated.

sourceChainV0TransactionsGetParametersSourceChainSchemaItems[]

Return only transactions whose source sent value on these networks, comma-separated.

typeV0TransactionsGetParametersTypeSchemaItems[]

Return only these movement types, comma-separated.

Headers

Authorizationstring required

Session JWT from POST /v0/auth/token, sent as Authorization: Bearer <sessionJwt>.

See Authentication for more details.

Response

OK

nextCursorstring nullable required

Opaque cursor for the next page. Pass back verbatim as the cursor query param; null when no more results.