Skip to main content
GET
Returns recent trades, newest first, merged across every chain and token in scope. Each trade includes its own chain and token.

What to read

Choose one of these reads:
  • tokens, a comma-separated list of 1 to 10 token addresses, reads the trades on those tokens.
  • wallets, a comma-separated list of 1 to 100 wallet addresses, reads the trades those wallets made.
  • tokens and wallets together read the named wallets’ trades on the named tokens.
  • identity alone reads one feed of notable wallets across every token. kol covers wallets labelled as key opinion leaders, and fomo covers wallets with a fomo.family profile.
A read that names wallets returns only the last 90 days of trades. chains limits results to a comma-separated list of chain slugs, such as solana,bsc. Omit it to include every chain. An address reads on every chain in scope of its format, so an EVM address reads on each EVM chain.

Filters

  • flags takes a comma-separated list of wallet classifications, such as bundler,insider. A trade is included when its trader has at least one of them. fomo matches traders flagged fomo and trades routed through the fomo.family terminal. flags applies only to a read by tokens.
  • side keeps only buy or sell trades. It applies only to a read by wallets.

Response

A page contains trades, nextCursor and hasMore. nextCursor is the cursor for the next page, or null on the last page, and hasMore is true while more pages remain. An unknown token or wallet returns an empty page, not a 404.

Pagination

  • Opaque cursors. The cursor must not be constructed, modified or parsed. Send it back exactly as received.
  • Stable pages. The cursor marks a position in the list, not an offset, so trades that arrive during pagination do not cause duplicated or skipped results.
  • One query per cursor. A cursor continues only the query that made it. Send the same parameters with each page.
  • Invalid cursors. An unreadable cursor returns 400 VALIDATION_ERROR on the cursor field rather than silently restarting from the first page.

Errors

Authorizations

Authorization
string
header
required

Send an API key, or a session token a key minted, as Authorization: Bearer <credential>. A browser opening /v1/stream offers its session token in Sec-WebSocket-Protocol instead.

Query Parameters

identity
enum<string>

Identity feed to read. A read that names it names no tokens or wallets. A cross-token feed of trades by a notable identity.

Available options:
kol,
fomo
tokens
string

Token addresses, CSV; one to 10. Each reads on every chain in scope of its address family.

wallets
string

Wallet addresses, CSV; one to 100. Each reads on every chain in scope of its address family.

chains
string

Chains to scope to, CSV of the chain slugs. Absent means every spot chain.

flags
string

Wallet classifications to keep, comma-separated. Absent or empty keeps every trade.

side
enum<string>

Keep only this side of the book. Which way the traded token moved: buy or sell.

Available options:
buy,
sell
limit
integer<int32>

Rows per page, clamped to 1-100; 20 when absent.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor from the previous page.

Response

Recent trades, newest first; a token or wallet with no trades adds none.

A page of trades, newest first.

hasMore
boolean
required

Whether a next page exists.

trades
object[]
required

Trades on the requested page, newest first.

nextCursor
string | null

Cursor for the next page; null on the last page.