Token Trades
GET /v1/tokens/:mint/trades returns a token's trades from the last 7 days, newest first, including token-to-token swaps.
- Endpoint
- GET
/v1/tokens/:mint/trades - Auth
- API key in the Authorization header
- Live
- The same data as a stream
Takes the trades stream's filters: sources, solOnly and minVolumeUsd / maxVolumeUsd. History covers the last 7 days. Same event shape as the trades stream.
Path parameters
mintstringSubject token mint address.
Quote assets (SOL, USDC, USDT) are rejected with 400 invalid_request — use metadata or price for those mints; use solOnly=true for SOL-paired history of a non-quote token.
Example
EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm
Query parameters
A parameter not listed here is rejected with 400 invalid_request, not ignored. Pass sources as a comma-separated list or source for one venue, not both. All venues
sourcesstringComma-separated venues, up to 20.
Every name must be a documented source; an unknown name returns 400. Send sources or source, not both.
All 23 values
pump_funpump_ammraydium_launchlabraydium_cpmmraydium_clmmraydium_v4meteora_dbcmeteora_damm_v2meteora_dlmmmeteora_poolsorca_whirlpoolpancakeswapjupiter_order_enginetessera_vbisonfigoonfi_v2zerofiscorchalphaqbyreal_clmmmanifestderiversebonkfunExample
pump_fun,pump_ammsourcestringA single venue, the one-value form of sources.
Send one of source or sources, not both.
solOnlybooleanWhen true, return only swaps where the other side is SOL.
Omit or set to false to include token-to-token swaps as well.
Example
trueminVolumeUsdnumberMinimum trade size in USD.
Rows with volumeUsd: null are excluded when either bound is set. Must be ≤ maxVolumeUsd.
Example
100maxVolumeUsdnumberMaximum trade size in USD.
Rows with volumeUsd: null are excluded when either bound is set.
limitnumberMaximum number of results (default 50, max 200).
Example
50cursorstringOpaque keyset cursor from the previous response's next field.
Endpoint-scoped — do not reuse across endpoints.
fromstringStart of the time window (ISO-8601 or unix ms).
Clamped to the 7-day history window.
Example
1751000000000tostringEnd of the time window (ISO-8601 or unix ms).
Example
1751008869000
Response fields
Fields of each item in the data array.
typestringAlways "swap".
signaturestringSwap transaction signature.
A swap routed through several pools arrives as one trade per hop, all with the same signature.
slotnumberSolana slot the event landed in.
Use for ordering and gap recovery.
timestampnumber | nullEvent time as a Unix epoch millisecond value. null when the block time is unknown (rare).
walletstringWallet the swap is credited to.
sourcestringDEX/venue.
See Sources.
volumeUsdnumber | nullTrade size in USD.
Trades against SOL, USDC or USDT are valued from that side. A token-to-token trade is valued from either token's price if it traded against SOL within the last hour: when both are priced and within 2× of each other, the fresher price; when further apart, the lower one. Otherwise null. Treat null as unknown, not zero (it fails a volume filter).
swapobject{ from, to }, each a leg { mint, symbol, amount (raw string), uiAmount (number), decimals }. from is what the wallet paid, to is what it received.
swap.from.symbol / swap.to.symbolstring | nullThe token's on-chain symbol (SOL, USDC and USDT are fixed). null for a token we haven't resolved yet, usually only its first second or two on the stream, or one with no on-chain symbol.
A label, not an identity: anyone can name a token USDC, so key on mint.
Last updated · Changelog