Messages
{
"op": "subscribed",
"id": "tape-1",
"channel": "trades",
"updatePeriod": 0
}{
"op": "event",
"id": "tape-1",
"channel": "trades",
"data": {
"id": "0x9d6dd98095ebcb254576b23b2269edf8fa984b581404209aa2a5fe3a14431bdf:289",
"at": 1786718835000,
"maker": "0x95d955179a7cd45aeef394ed39f6a8d8b1bd1e09",
"displayName": null,
"avatarUrl": null,
"twitter": null,
"entityName": null,
"entityType": null,
"isBuy": true,
"amountToken": 77.05662024406023,
"amountQuote": 0.000042612402192036,
"amountTokenRaw": null,
"amountQuoteRaw": null,
"quoteToken": {
"address": "0x4200000000000000000000000000000000000006",
"symbol": "WETH",
"name": "Wrapped Ether",
"decimals": 18,
"iconUrl": "https://cdn.serialized.xyz/dex/coin-eth.d7604bb1.png"
},
"priceNative": 5.4747124708872e-7,
"priceUsd": 0.00103052429,
"quotePriceUsd": 1882.34,
"fdvNative": 19663.26,
"fdvUsd": 37012842.54,
"volumeNative": 0.000042612402192036,
"volumeUsd": 0.08021081608014609,
"feesNative": 0.0000021,
"gasFeesUsd": 0.0039529,
"mevFeesUsd": null,
"platformFeesUsd": null,
"totalFeesUsd": 0.0039529,
"isProTrader": false,
"isSniper": false,
"isWash": null,
"labels": [],
"preconfirmed": false,
"txHash": "0x9d6dd98095ebcb254576b23b2269edf8fa984b581404209aa2a5fe3a14431bdf",
"block": 49964744,
"logIndex": 289,
"poolAddress": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64"
},
"asOf": 1786718835412,
"cursor": "v1.amuk773y4ih91.2kx.mfq3c2y2"
}{
"op": "subscribe",
"channel": "trades",
"id": "tape-1",
"params": {
"chain": "evm:8453",
"address": "0xb2000000000000000000007bf6d5cbb0e24cb301"
}
}Tokens & pools
Trades Stream
Every new trade of a token (all its pools by default, or a pool subset) or of one market, pushed as it lands, optionally only the trades of the wallets of one of your watchlists. Events are the exact REST /v1/token/trades shape, one event per trade.
WS channel: trades
Every new trade of a token (all its pools by default, or a pool subset) or of one market, pushed as it lands. Events are the exact REST /v1/token/trades shape, one event per trade: the live twin of /v1/token/trades and /v1/pool/trades.
Token address (EVM hex, case-insensitive; Solana base58). Required unless you pass
pool. tokenAddress is accepted as the same parameter. Example: 0xb2000000000000000000007bf6d5cbb0e24cb301Comma-separated pool addresses to restrict the tape of
address, 1 to 50 (REST /v1/token/trades accepts up to 200; beyond 50, the subscription is refused with INVALID_PARAM). Default: token-wide (every pool of the token).One market instead of a token: the tape of that pool, the live twin of
/v1/pool/trades. Pass chain and pool, without address. poolAddress is accepted as the same parameter. Example: 0x0ca6485b7e9cf814a3fd09d81672b07323535b64Native coins (
0x0000…0000 and 0xeeee…eeee on every chain, Solana included, the wrapped native such as WETH or WBNB, and the SOL mint) stream the trades of the coin’s main USD markets, seen from the coin, like REST /v1/token/trades: buying the stablecoin with ETH is a sell of ETH, amountToken is in the coin, quoteToken and amountQuote are the stablecoin, priceUsd is the trade’s own rate. pools accepts a subset of those markets, the first rows of /v1/token/pools.Comma-separated wallet labels: only the trades whose maker carries at least one of them at the time of the trade are pushed (
dev, sniper, bundler, whale, proTrader, smartTrader, freshTrader, kol). The same rule as the labels filter of /v1/token/trades without a wallet filter. On a native coin’s feed only proTrader, smartTrader, freshTrader and kol apply. Example: whale,kolEvery event carries the maker’s wallet labels at the time of the trade in
labels, the same list as REST.The id of one of your watchlists: only the trades whose maker is a wallet of the list are pushed, and only those are billed. It narrows the token (
address, with or without pools) or the market (pool) you subscribe to, and combines with labels: the same rule as the watchlist filter of /v1/token/trades. The wallets that count are those of the chain of the subscription; on an EVM chain, also those added with chains: "evm". Any list size: one subscription follows a list of 200,000 wallets. Wallets you add or remove over REST are applied within seconds, without subscribing again. Not with updatePeriod: "block". Example: app-usersMilliseconds, 0 to 60000, or
"block"; default 0 (every trade as it lands, one event per trade). Above 0, one message per period carries every trade of the period in order, as "data": [trade, ...], with the cursor of the last one; if more than 256 trades pile up in one period, the oldest are dropped and the message carries "gap": true. "block": one message per chain and per block, with every trade of that block. The ack carries the value applied (snapped up to 0, 100, 200, 250, 500, 1000, 2000, 5000, 10000, 30000, 60000). See Choosing your pace.{
"op": "subscribe",
"channel": "trades",
"id": "tape-1",
"params": {
"chain": "evm:8453",
"address": "0xb2000000000000000000007bf6d5cbb0e24cb301"
}
}
{
"op": "subscribe",
"channel": "trades",
"id": "tape-users",
"params": {
"chain": "solana",
"address": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump",
"watchlist": "app-users"
}
}
{
"op": "subscribed",
"id": "tape-1",
"channel": "trades",
"updatePeriod": 0
}
{
"op": "subscribed",
"id": "tape-users",
"channel": "trades",
"updatePeriod": 0,
"watchlist": { "id": "app-users", "version": 1843, "wallets": 200000 }
}
{
"op": "event",
"id": "tape-1",
"channel": "trades",
"data": {
"id": "0x9d6dd98095ebcb254576b23b2269edf8fa984b581404209aa2a5fe3a14431bdf:289",
"at": 1786718835000,
"maker": "0x95d955179a7cd45aeef394ed39f6a8d8b1bd1e09",
"displayName": null,
"avatarUrl": null,
"twitter": null,
"entityName": null,
"entityType": null,
"isBuy": true,
"amountToken": 77.05662024406023,
"amountQuote": 0.000042612402192036,
"amountTokenRaw": null,
"amountQuoteRaw": null,
"quoteToken": { "address": "0x4200000000000000000000000000000000000006", "symbol": "WETH", "name": "Wrapped Ether", "decimals": 18, "iconUrl": "https://cdn.serialized.xyz/dex/coin-eth.d7604bb1.png" },
"priceNative": 5.4747124708872e-7,
"priceUsd": 0.00103052429,
"quotePriceUsd": 1882.34,
"fdvNative": 19663.26,
"fdvUsd": 37012842.54,
"volumeNative": 0.000042612402192036,
"volumeUsd": 0.08021081608014609,
"feesNative": 0.000000841192,
"gasFeesUsd": 0.00158341,
"mevFeesUsd": null,
"platformFeesUsd": null,
"totalFeesUsd": 0.00158341,
"isProTrader": false,
"isSniper": false,
"isWash": null,
"labels": [],
"preconfirmed": false,
"txHash": "0x9d6dd98095ebcb254576b23b2269edf8fa984b581404209aa2a5fe3a14431bdf",
"block": 49964744,
"logIndex": 289,
"poolAddress": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64"
},
"asOf": 1786718835412,
"cursor": "v1.amuk773y4ih91.2kx.mfq3c2y2"
}
{
"op": "event",
"id": "tape-1",
"channel": "trades",
"data": { "id": "0x9d6dd98095ebcb254576b23b2269edf8fa984b581404209aa2a5fe3a14431bdf:289", "…": "…" },
"asOf": 1786718835412,
"cursor": "v1.amuk773y4ih91.2kx.mfq3c2y2",
"replay": true
}
Events are the exact REST
/v1/token/trades Trade shape, including the stable id for dedup, the transaction fees by part (gasFeesUsd, mevFeesUsd, platformFeesUsd, totalFeesUsd), the raw amounts amountTokenRaw / amountQuoteRaw (Solana; null on EVM chains), the maker’s public profile (displayName, avatarUrl, twitter) and entity (entityName, entityType) and the token’s fully diluted valuation at the price of the trade (fdvUsd = priceUsd × the token’s total supply, fdvNative the same in the native coin). These raw amounts, profile and entity fields and valuations may be null on an event when the value is not known at the moment the trade is pushed: GET / POST /v1/token/trades is the reference. isWash is a boolean on Solana and null on EVM (no wash tagging there). On Solana, at carries the sub-second time of the trade, in the same second as the at REST serves for the same id: merge by id, and order trades inside a second by their cursor.Billing
1 credit per pool with a trade in each message: every trade costs 1 at the default pace, and a batch (updatePeriod) costs 1 per pool it carries. With watchlist, only the trades of the list’s wallets are sent, and only what is sent is billed: a token traded all day by other wallets costs nothing. Details in Billing.
Following a watchlist
- The ack carries
watchlist: the list’sid, theversionapplied and itswalletsat that version. Nothing is sent before it. - Changes apply live: wallets you add or remove over REST are followed or dropped within seconds. A cleared list sends nothing until you add wallets again.
- The end of the list ends the subscription: when the watchlist is deleted or purged, the subscription receives
NOT_FOUNDwithdetails.watchlistanddetails.reason, and ends. An unknown id is refused the same way atsubscribe. - When the list cannot be read right now, the
subscribeis refused withUPSTREAM_ERRORanddetails.retryAfterMs: send it again after that delay. - One subscription, whatever the size of the list; reading the trades of a list counts as use of the list (unused watchlists).
- The page behind it: read the recent trades of the list’s wallets with
/v1/token/tradesandwatchlist=<id>, then apply the events as they come, deduped bydata.id.
Resume
Every event carries acursor. After a reconnect, subscribe again with "since": "<cursor of the last trade you received>": you receive every trade after it (up to 5 minutes back), then live. With watchlist, send the same watchlist: the trades replayed are those of the list’s wallets, after the ack. Trades you may already have are flagged "replay": true: dedupe them by data.id. If the replay is not available, a REPLAY_TOO_OLD notice gives details.restFromMs: fetch /v1/token/trades with fromAt from there, the subscription keeps going. See Reconnect & resume.
Close codes
| Code | Meaning |
|---|---|
4401 | Auth - key missing, invalid, or revoked. Live connections are dropped the moment a key is revoked. |
4402 | Credits or billing: the WebSocket mirror of REST 402 / 403. The close reason says what to do (see Errors). |
1012 | Server restart - reconnect after the retryAfterMs of the JSON reason, then subscribe again with since. |
1013 | Server at capacity - reconnect after the retryAfterMs of the JSON reason. |
1008 | Policy - subscription limits, flooding, or a blocked socket. Fix the cause before reconnecting. |
1001 | Nothing received from you for 60 s (idle timeout), or for 35 s while our WebSocket ping waits for its answer (no answer to pings). Send a ping every 15 to 30 s; after no answer to pings, reconnect and resume. |
1009 | A frame you sent is over 64 KB. |
restFromMs (JSON, on a 1012 or a 1008), some trades of this connection may be missing: fetch them with fromAt from there. After a 1012 or 1013, reconnect (with a backoff, see Reconnect & resume) and resume each subscription with since.Messages
{
"op": "subscribed",
"id": "tape-1",
"channel": "trades",
"updatePeriod": 0
}{
"op": "event",
"id": "tape-1",
"channel": "trades",
"data": {
"id": "0x9d6dd98095ebcb254576b23b2269edf8fa984b581404209aa2a5fe3a14431bdf:289",
"at": 1786718835000,
"maker": "0x95d955179a7cd45aeef394ed39f6a8d8b1bd1e09",
"displayName": null,
"avatarUrl": null,
"twitter": null,
"entityName": null,
"entityType": null,
"isBuy": true,
"amountToken": 77.05662024406023,
"amountQuote": 0.000042612402192036,
"amountTokenRaw": null,
"amountQuoteRaw": null,
"quoteToken": {
"address": "0x4200000000000000000000000000000000000006",
"symbol": "WETH",
"name": "Wrapped Ether",
"decimals": 18,
"iconUrl": "https://cdn.serialized.xyz/dex/coin-eth.d7604bb1.png"
},
"priceNative": 5.4747124708872e-7,
"priceUsd": 0.00103052429,
"quotePriceUsd": 1882.34,
"fdvNative": 19663.26,
"fdvUsd": 37012842.54,
"volumeNative": 0.000042612402192036,
"volumeUsd": 0.08021081608014609,
"feesNative": 0.0000021,
"gasFeesUsd": 0.0039529,
"mevFeesUsd": null,
"platformFeesUsd": null,
"totalFeesUsd": 0.0039529,
"isProTrader": false,
"isSniper": false,
"isWash": null,
"labels": [],
"preconfirmed": false,
"txHash": "0x9d6dd98095ebcb254576b23b2269edf8fa984b581404209aa2a5fe3a14431bdf",
"block": 49964744,
"logIndex": 289,
"poolAddress": "0x0ca6485b7e9cf814a3fd09d81672b07323535b64"
},
"asOf": 1786718835412,
"cursor": "v1.amuk773y4ih91.2kx.mfq3c2y2"
}{
"op": "subscribe",
"channel": "trades",
"id": "tape-1",
"params": {
"chain": "evm:8453",
"address": "0xb2000000000000000000007bf6d5cbb0e24cb301"
}
}Ack
type:object
Server acknowledgement: the subscription is live.
Trade
type:object
Server push frame (Trade).
Subscribe
type:object
Client frame opening the subscription (additive, ack is explicit).