{} 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.
poolsrejects 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.kolmatches trades by key opinion leaders.- The
fomoflag matches trades by wallets that have traded through the fomo.family terminal in any token on the chain. - The
fomoplatform 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: truematches a sell that leaves the trader with none of the token, andfalsematches 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.
priceImpactPctis 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
tokenkey is open. Immediately after subscribing, trades do not matchtokenuntil 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’sdata 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.