Skip to main content
GET
GET /v1/wallet/transfers · 1 credit Token in/out history of a wallet over the last 90 days, newest first: deposits, withdrawals, plain transfers - timestamp (ms), token, amount, direction, counterparty, tx hash. Paginate with the opaque cursor from meta.nextCursor: exact pagination that never skips or repeats a transfer. The reconciliation primitive next to /v1/wallet/trades.
Pagination. A page serves up to limit token movements of the wallet, newest first: a transaction that moved several tokens adds several rows, a transaction that only swapped adds none (swaps are on /v1/wallet/swaps). On Solana a transaction is never split across two pages, so a page can hold a few more or fewer than limit rows while meta.hasMore is true; with the spam filter on (the default) a page can hold fewer rows than limit, even none, while meta.hasMore is true. Keep passing meta.nextCursor until hasMore is false; cursors never skip or repeat a transfer, and hasMore: false means the wallet’s history is fully served. meta.nextCursor is present while meta.hasMore is true.
Spam. Wallet histories fill up with movements the owner never made: airdropped lookalikes of real assets, dust from tokens with no market and, on EVM chains, fake transfers that a token contract records as sent from the wallet without the wallet’s signature (often to a lookalike of an address the wallet has sent to). By default (excludeSpam=true) the transfers judged spam are left out of the page: a token outside our registry worth less than $0.05 at transfer time (the same floor /v1/wallet/positions applies by default) or with no market at all. On EVM chains, incoming and outgoing transfers are judged alike, and a transfer to a burn address is always served; on Solana, outgoing transfers are always served. Every token of our registry (stablecoins, the native coin and its wrapped form, known assets) is always served. Every row carries spam: true (judged spam, returned only with excludeSpam=false), false (judged and kept) or null (not judged: the USD value of that transfer could not be read at that moment, kept). Pass excludeSpam=false to receive every row and build your own toggle on spam.
Time window and order. Transfers cover a rolling window of the last 90 days: meta.historyFrom (unix ms) is the earliest instant covered, and a window that starts earlier is served from that instant. from and to bound the history in unix milliseconds, both inclusive; order is desc (newest first, default) or asc. They combine with cursor: keep the same from, to and order on every page of a walk. meta.oldestAt is the oldest timestamp of the page.
direction is in or out; counterparty is the other side of the transfer (the zero address for a mint or a burn: 11111111111111111111111111111111 on Solana). Amounts are strings for precision, in token units; amountUsd is the USD value of the transfer (null for a token with no price).

Authorizations

Authorization
string
header
required

Your raw API key (not needed on the demo server).

Query Parameters

chain
string
required

Public chain id - evm:<id> or solana.

wallet
string
required

Wallet address.

limit
integer
default:50

Transfers per page (default 50, max 100). On Solana a transaction is never split across two pages, so a page can hold a few more or fewer rows than limit.

Required range: 1 <= x <= 100
cursor
string

Opaque resume token from meta.nextCursor - exact pagination, no skip or duplicate.

from
integer

Inclusive lower time bound, unix MILLISECONDS. A value in seconds is rejected (400).

Required range: x >= 0
to
integer

Inclusive upper time bound, unix MILLISECONDS. A value in seconds is rejected (400).

Required range: x >= 0
order
enum<string>
default:desc

Sort order by time: desc (newest first, default) or asc. Keep the same order on every page of a walk.

Available options:
asc,
desc
excludeSpam
boolean
default:true

Leave out the transfers judged spam: a token outside our registry worth less than $0.05 at transfer time (the floor /v1/wallet/positions applies by default) or with no market at all. On EVM chains, incoming and outgoing transfers are judged alike (a token contract can record a transfer out of a wallet without the wallet's signature), and a transfer to a burn address is always served; on Solana, outgoing transfers are always served. Every token of our registry (stablecoins, the native coin and its wrapped form, known assets) is always served. Default true. With the filter on, a page can hold fewer rows than limit, even none, while meta.hasMore is true: keep paging. Pass false to receive every row.

Response

200

Standard { data, meta } envelope.