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

mintstring

Subject 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

sourcesstring

Comma-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_clmmmanifestderiversebonkfun

Example pump_fun,pump_amm

sourcestring

A single venue, the one-value form of sources.

Send one of source or sources, not both.

solOnlyboolean

When true, return only swaps where the other side is SOL.

Omit or set to false to include token-to-token swaps as well.

Example true

minVolumeUsdnumber

Minimum trade size in USD.

Rows with volumeUsd: null are excluded when either bound is set. Must be ≤ maxVolumeUsd.

Example 100

maxVolumeUsdnumber

Maximum trade size in USD.

Rows with volumeUsd: null are excluded when either bound is set.

limitnumber

Maximum number of results (default 50, max 200).

Example 50

cursorstring

Opaque keyset cursor from the previous response's next field.

Endpoint-scoped — do not reuse across endpoints.

fromstring

Start of the time window (ISO-8601 or unix ms).

Clamped to the 7-day history window.

Example 1751000000000

tostring

End of the time window (ISO-8601 or unix ms).

Example 1751008869000

Response fields

Fields of each item in the data array.

typestring

Always "swap".

signaturestring

Swap transaction signature.

A swap routed through several pools arrives as one trade per hop, all with the same signature.

slotnumber

Solana slot the event landed in.

Use for ordering and gap recovery.

timestampnumber | null

Event time as a Unix epoch millisecond value. null when the block time is unknown (rare).

walletstring

Wallet the swap is credited to.

sourcestring

DEX/venue.

See Sources.

volumeUsdnumber | null

Trade 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 | null

The 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