Skip to main content
GET
GET /v1/wallet/trades · 2 credits
Live: the wallet-trades stream channel pushes the trades of the wallets you follow as they land, with the same fields.
Trade history of a wallet on one chain or several, newest first - multihop-deduplicated (one event per transaction, token and side; never doubled volumes). An order split across several pools in one transaction is one event with the full amount and volume, on the pool of its largest part. Paginate with the opaque cursor from meta.nextCursor on both EVM and Solana: exact keyset pagination that never skips or repeats a trade. Pass chain for one chain or chains for several: one timeline across those chains, newest first, with one cursor. Routed intermediate legs (the wSOL, stable or quote a route passes through) are excluded by default and flagged isRoutingHop; pass includeRoutingHops=true to include them. Wash/MEV rows are kept and carry the isWash badge (Solana) so consumers choose.
Building a wallet activity feed? Use GET /v1/wallet/swaps: one row per transaction, a routed swap reads as a single swap (what the wallet sent, what it received), with every leg, its venue and its router.
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 trade, and hasMore: false means the wallet’s history is fully served.
Several chains. chains takes public chain ids, comma-separated (chains=evm:8453,evm:1) or as a repeated parameter (chains=evm:8453&chains=evm:1); evm stands for every EVM chain and combines with explicit ids. The trades of every listed chain come back as one timeline, newest first, each row with its chain, and meta.nextCursor pages through the whole timeline. A cursor stays valid when you switch between chain and chains. Every chain must belong to the wallet’s family: EVM chains for a hex address, solana for a base58 address. Send chain or chains, not both; one of the two is required. The call costs 2 credits whatever the number of chains. meta.usdBasis is trade unless a served trade comes from a chain valued at today’s price (spot).
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.
Each trade carries wallet (the wallet that traded: the address you asked for, lowercase on EVM), feesNative and gasFeesUsd, mevFeesUsd, platformFeesUsd, totalFeesUsd (the fees of the transaction, in the native unit and in USD by part at the rate of volumeUsd, as defined on /v1/token/trades; null when not known for the row), isRoutingHop (a routed intermediate leg) and isWash (Solana wash/MEV flag; null on EVM). quoteToken is the token the trade was priced against, the quote of the pool in poolAddress (native, wrapped native, a stablecoin or another token), with its address, symbol, name, decimals and iconUrl (its logo), and amountQuote is the amount of that token the wallet paid or received, in its units: the same two fields as /v1/token/trades. volumeUsd is valued at the native coin’s USD price at the time of the trade, on EVM and Solana alike; meta.usdBasis says how it was computed (trade = each trade valued at the native coin’s USD price at that trade’s minute). meta.nextCursor is present while meta.hasMore is true.

Authorizations

Authorization
string
header
required

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

Query Parameters

chain
string

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

chains

Public chain ids, comma-separated or as a repeated parameter: evm:<id>, solana, or evm for every EVM chain (combine it with explicit ids freely). Several chains give one timeline, newest first, with one cursor; every trade carries its chain. Every chain must belong to the wallet's family (EVM chains for a hex address, solana for a base58 address). Send chain or chains, not both.

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

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: trades 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
includeRoutingHops
boolean
default:false

Also serve the intermediate legs of routed swaps, flagged isRoutingHop. Default false.

Response

200

Standard { data, meta } envelope.