Skip to main content
GET
GET /v1/wallet/swaps · 1 credit Swap history of a wallet, newest first - one row per transaction. sent is what the swap took from the wallet and received what it delivered, netted across every leg of the transaction, so a routed swap reads from end to end: a USELESS to USDC sale routed through SOL reads as USELESS sent, USDC received. The assets a route only passes through and the fees taken between its hops do not appear, and the native coin and its wrapped form count as one asset. Every asset carries its symbol, name and decimals. route lists every leg with its pool and venue type, ordered from the sent asset to the received asset. On Solana each swap and each leg carries router, the program that routed it (Jupiter, OKX DEX, DFlow, Titan…), with its name when known and null for a direct swap, so a feed can render “Jupiter via BisonFi”. Built for wallet activity feeds; for a per-token trade tape use GET /v1/wallet/trades. Same opaque cursor pagination on EVM and Solana: it never skips or repeats a transaction. Batch twin: POST /v1/wallet/swaps, up to 20 wallets per call.
Reading a row. sent and received are the net flows of the swap across every leg of the transaction, largest first. Each asset carries tokenAddress, symbol, name, decimals (null when the token is not known) and amount. A routed swap reads from end to end: the assets the route only passes through do not appear, nor do the fees taken between its hops. The native coin and its wrapped form are one asset (on EVM, Uniswap v4 pays native ETH where other venues pay WETH): it is served under the form the route used, and each leg of route keeps the exact asset it exchanged. A transaction that holds two independent swaps lists both on each side. route lists each leg with its poolAddress, its venue poolType, and what that leg sent and received. volumeNative and volumeUsd are the value of the swap; volumeUsd is at the current native price on EVM, and valued at the SOL price at the time of the swap on Solana, where meta.usdBasis reports trade. feesNative is the total fee paid for the transaction in the chain’s native unit (null when it is not available for that row). On Solana, router is the program that routed the swap: programId always, name when the program is a known router (Jupiter, OKX DEX, DFlow, Titan…), and router: null for a direct swap. The swap-level router is the one of its largest routed leg; each leg of route carries its own. The field is present on swaps from 2026-09-21 onward.
Pagination. Each page is bounded by limit and by a scan window over the wallet’s history: a page can hold fewer than limit rows while meta.hasMore is true. Keep passing meta.nextCursor until hasMore is false; cursors never skip or repeat a transaction, and hasMore: false means the wallet’s history is fully served.
Time window. from and to bound the history in unix milliseconds, both inclusive, and combine with cursor. fromAt (the same lower bound) and beforeAt (strictly older) remain supported; pass one name per bound.
Several wallets. POST /v1/wallet/swaps takes up to 20 wallets per call, EVM and Solana mixed, each with its own cursor, billed per wallet.

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 (EVM hex, case-insensitive; Solana base58).

​
cursor
string

Opaque resume token from meta.nextCursor - exact keyset pagination on both EVM and Solana, no skip or duplicate.

​
limit
integer
default:50
required

1-100. Default 50.

Required range: 1 <= x <= 100
​
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
​
beforeAt
integer

Upper bound, unix MILLISECONDS: swaps strictly older. A value in seconds is rejected (400). Prefer cursor for exact pagination.

Required range: x >= 0
​
fromAt
integer

Inclusive lower time bound (ms).

Required range: x >= 0

Response

200

Standard { data, meta } envelope.