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
trades sends swap events
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_clmmmanifestderiversebonkfun

Example ["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 omit mints to receive all trades; when set, max 100. Quote assets (SOL, USDC, USDT) are rejected here — use solOnly: true for SOL-paired trades.

Example ["EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm"]

solOnlyboolean

Trades 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 true

walletsstring[]

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"]

minVolumeUsdnumber

Minimum trade size in USD (volumeUsd).

A set bound excludes events with volumeUsd: null. Must be ≤ maxVolumeUsd.

Example 100

maxVolumeUsdnumber

Maximum 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.

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