Token Trades
The trades stream sends a swap event for every DEX trade on Solana across 22 decoded programs, with both legs, the trader's wallet and a USD value.
- Channel
tradessendsswapevents- Plans
- FreeNot included
- StarterTrack up to 25 tokens at once (mints is required)
- Pro and EnterpriseAll tokens, unlimited. Filters optional
- History
Filters
Filters narrow trades events before they are sent to you. A filter the trades channel doesn't take is rejected with invalid_filters, not ignored. REST takes the same filters as query parameters. Filters on REST and WebSocket
sourcesstring[]Filter by venue, 1–20 names.
Every name must be a documented source; an unknown name is rejected with invalid_filters.
All 23 values
pump_funpump_ammraydium_launchlabraydium_cpmmraydium_clmmraydium_v4meteora_dbcmeteora_damm_v2meteora_dlmmmeteora_poolsorca_whirlpoolpancakeswapjupiter_order_enginetessera_vbisonfigoonfi_v2zerofiscorchalphaqbyreal_clmmmanifestderiversebonkfunExample
["pump_fun"]mintsstring[]Token mint addresses to track (OR across swap legs).
Starter must pass
mints(required, up to 25 tokens at once) — a coverage cap for the tokens you watch. Pro may omitmintsto receive all trades; when set, max 100. Quote assets (SOL, USDC, USDT) are rejected here — usesolOnly: truefor SOL-paired trades.Example
["EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm"]solOnlybooleanTrades only.
When true, keep swaps where at least one leg is wrapped SOL. ANDs with every other filter (e.g. mints + solOnly → those tokens paired with SOL only). Omit or false = no constraint. Rejected on every other channel.
Example
truewalletsstring[]Only trades credited to these wallets, 1–100 addresses.
Combines with mints and the other filters. Backfill a wallet with GET /v1/wallets/:wallet/trades.
Example
["5FHwkW5742VKq9W8pN3mL7jR2sT6cX4bY1zD8gH9K2pQ"]minVolumeUsdnumberMinimum trade size in USD (volumeUsd).
A set bound excludes events with volumeUsd: null. Must be ≤ maxVolumeUsd.
Example
100maxVolumeUsdnumberMaximum trade size in USD (volumeUsd).
A set bound excludes events with volumeUsd: null.
Example
50000
Event fields
Every field of the swap event the trades stream sends, as shown in the example.
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