List address transactions

List the transactions on a chain that involve an address: as the recipient, as the
contract created, on either side of a transfer or network fee, or as the owner or spender
of a token approval. A transaction the address only sent is listed while it is pending,
or when it has no transfers. Each transaction appears once, with its value movements in
transfers and its token approvals in approvals.

Filters take a value for an exact match, or an operator in bracket notation, for example
amount[gte]=100. A transaction must match every filter.

To page forward, pass pageInfo.endCursor as after. A cursor works only with the sort
and order it was issued under; otherwise the request returns 400. For numbered pages,
pass page with first: the response then includes pageInfo.totalCount. Forward paging
only: last and before are ignored, except that sending either with page returns 400,
as does combining page with a cursor.

To reconcile without missing transactions, sort by indexedAt in asc order, end each
from/to window a little in the past, and overlap consecutive windows. De-duplicate on
id: transactionHash is null on an orphaned transaction, so (chain, transactionHash)
cannot tell orphaned transactions apart. indexedAt is when the transaction was first indexed and
does not change when it confirms or gains transfers, so keep re-reading a transaction that
is not yet finalized with GET /v2/treasury/transactions/{id}, and replace your stored
copy instead of discarding it as a duplicate. To identify a single movement, use logIndex with
eventIndex, or tracePath, when they are set. For a leg with neither, such as a native,
gas or non-EVM leg, the transaction (id) is the unit. Do not use legIndex,
which can change when a transaction is re-indexed.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Chain alias, such as ethereum, avalanche-c, solana, tron, bitcoin or ripple, not a numeric chain ID. GET /v2/treasury/chains lists the canonical aliases of the chains you can use, and includes testnets with includeTestnets=true. Older aliases such as btc are also accepted.

string
required
length ≥ 1

On-chain address in the format of the chain the request names, in the path or the body: EVM 0x hex, Solana base58, Tron T… base58, Bitcoin bc1… or legacy (testnets tb1…), XRP r….

Query Params
integer
-9007199254740991 to 200

Forward pagination: maximum number of items to return, starting after after. Range 1 to 200; defaults to 50 when omitted. Do not combine with last/before.

integer
-9007199254740991 to 200

Backward pagination: maximum number of items to return, ending before before. Range 1 to 200; defaults to 50 when omitted. Do not combine with first/after.

string
length ≥ 1

Backward-pagination cursor. Pass a pageInfo.startCursor from a previous response to fetch the page immediately before it. Use with last; do not combine with first/after.

string
length ≥ 1

Forward-pagination cursor. Pass a pageInfo.endCursor from a previous response to fetch the next page. Use with first; do not combine with last/before.

integer
-9007199254740991 to 200

Deprecated alias for first.

string
length ≥ 1

Deprecated alias for after.

string
enum
Defaults to desc

Sort direction. desc (default) returns the newest first, asc the oldest first. When sorting by blockTimestamp, pending transactions come last in both directions.

Allowed:
string
enum
Defaults to visible

Which transactions to list, by the classification of their transfers. visible (default): transactions with at least one visible transfer, or none. hidden or spam: transactions with at least one transfer so classified. all: every transaction. A transfer takes the classification you set for its asset on your address, otherwise spam if the asset is flagged as spam, otherwise visible. Native transfers are always visible.

Allowed:
integer
-9007199254740991 to 45035996273704

Page number, starting at 1. A page past the end returns the last page. Cannot be combined with cursor or backward pagination.

string | object

Filter by transaction status. Operators: eq, neq, in, notIn.

string | object

Filter by transaction category. Operators: eq, neq, in, notIn, isNull.

string | object

Filter by risk level. Operators: eq, neq, in, notIn, isNull.

string | object

Filter by protocol name. Operators: eq, neq, like, ilike, isNull, isNotNull.

string | object

Filter by contract method name. Operators: eq, neq, like, ilike, isNull, isNotNull.

string | object

Filter by transaction hash. Operators: eq, neq, like, ilike, isNull, isNotNull.

string | object

Filter by the ID of the transaction request that created the transaction. Operators: eq, neq, like, ilike, isNull, isNotNull.

string | object

Filter by block timestamp (ISO 8601). Operators: eq, neq, gt, gte, lt, lte, isNull, isNotNull.

string | object

Filter by transfer amount, as a human decimal string. Operators: eq, neq, gt, gte, lt, lte, isNull, isNotNull.

string | object

Filter by transfer value in USD at the time of the transaction. Operators: eq, neq, gt, gte, lt, lte, isNull, isNotNull.

string | object

Filter by transfer asset symbol, for example USDC. Operators: eq, neq, like, ilike, isNull, isNotNull.

string | object

Filter by transfer asset contract address. Operators: eq, neq, like, ilike, isNull, isNotNull.

string | object

Filter by transfer asset type. Operators: eq, neq, in, notIn.

string | object

Filter by transfer sender address, in canonical form (lowercase on EVM). Operators: eq, neq, like, ilike, isNull, isNotNull.

string | object

Filter by transfer recipient address, in canonical form (lowercase on EVM). Operators: eq, neq, like, ilike, isNull, isNotNull.

string
enum
Defaults to blockTimestamp

Timestamp to sort and window (from, to) on. blockTimestamp (default) is the on-chain time. It is empty while a transaction is pending and can change on a reorg, so transactions can move between pages. indexedAt is when io.vault first recorded the transaction and never changes. Use indexedAt to reconcile.

Allowed:
date-time

Start of the window on the sort timestamp, inclusive. ISO 8601 with offset, up to microsecond precision. With sort=blockTimestamp, a window excludes pending transactions, which have no block timestamp yet.

date-time

End of the window on the sort timestamp, exclusive. ISO 8601 with offset, up to microsecond precision. Pass the to of one window as the from of the next to cover time with no gap.

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json