Skip to main content
Streams every trade that matches the subscription’s filters, in real time. Each trade is tested once, as it happens, and {} matches every trade on every chain. Subscribe on an open stream connection. See WebSocket streams for connections, frames and reconnection, and Filtering streams for how keys, lists and ranges combine.

Filters

Addresses

tokens, wallets and pools each cover every chain in their address family that chains includes. A 0x… wallet therefore covers BSC, Robinhood Chain and Elysium at once, unless chains narrows it.
  • Omit a list to match every address. An empty list is rejected.
  • These three lists have no limit of their own; only the address limit applies.
  • pools rejects the zero address.

Flags and platforms

A flag matches when the trader carries it, either on this token or on the wallet. The glossary defines each flag.
  • kol matches trades by key opinion leaders.
  • The fomo flag matches trades by wallets that have traded through the fomo.family terminal in any token on the chain.
  • The fomo platform matches trades routed through the fomo.family terminal.
traderSources is the method used to identify an EVM trade’s trader: swap_recipient, tx_origin, launchpad_buyer, settlement_endpoint, authority7702, user_op_sender, relay_caller or pool_caller. Solana trades have no trader source, so they never match this key.

Trade values

  • fullExit: true matches a sell that leaves the trader with none of the token, and false matches every other trade. A sell whose post-trade balance is unknown matches neither.
  • A zero price, market cap or liquidity on a trade means the value was not measured, so it does not match any range.
  • priceImpactPct is accepted but matches no trade, because trades do not include a pre-trade price.

Token state

token tests the latest state of the traded token, as seen by spot.tokens.
  • A token has a state only after it changes while a subscription with a token key is open. Immediately after subscribing, trades do not match token until their token changes again.
  • A state expires after 15 minutes without a change.
  • A trade and the matching token change can be processed in either order, so the first trades after a quiet period can be missed.

Message format

Each update’s data is one trade, in the same shape that Trades returns. It includes flags, platforms and identities when the trade has any; empty lists are omitted.

Errors

Unsupported filters

spot.trades rejects the following filters. Use the replacement in the right column instead.