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.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||