Agora Public APIEndpointsTransactions

List Transactions

Beta
<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](/api/endpoints/transactions/getbyid). Narrow the list with `type`, `sourceChain`, `recipientChain`, `isInstantSettlement`, and an `initiatedAt` range; every filter you send must hold (see [Filtering list endpoints](/api#filtering-list-endpoints)). The chain filters match the `source` and `recipient` the response reports, so a mint funded by wire matches on `recipientChain` only.

Authentication

AuthorizationBearer

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

See Authentication for more details.

Query parameters

cursorstringOptional

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

limitintegerOptional1-200Defaults to 50

Page size. Defaults to 50; capped at 200.

initiatedAt.gtdatetimeOptional

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

initiatedAt.gtedatetimeOptional

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

initiatedAt.ltdatetimeOptional

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.ltedatetimeOptional

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

isInstantSettlementenumOptional

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.

Allowed values:
recipientChainlist of enumsOptional

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

sourceChainlist of enumsOptional

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

typelist of enumsOptional

Return only these movement types, comma-separated.

Allowed values:

Response

OK
datalist of objects

Page of transactions, newest first (by initiated time, tie-broken by id).

nextCursorstring or null

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

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error