Messages
{
"op": "subscribed",
"id": "tok-1",
"channel": "token-updates",
"updatePeriod": 100
}{
"op": "event",
"id": "tok-1",
"channel": "token-updates",
"data": {
"chain": "solana",
"address": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump",
"tokenAddress": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump",
"poolAddress": "Ea5SjE2Y6yvCeW5dYTn7PYMuW5ikXkvbGdcmSnXeaLjS",
"priceNative": "0.000000028472524478",
"priceUsd": 0.0000021952461580276,
"marketCapUsd": 2195.24,
"fdvUsd": 2195.24,
"liquidityUsd": 2348.64,
"pooledBase": null,
"pooledQuote": null,
"pooledBaseNative": null,
"pooledQuoteNative": null,
"launchpad": {
"migrated": false,
"bondingProgress": 38.6,
"graduatedAt": null
},
"stats24h": {
"volumeUsd": 16738.29,
"buys": 412,
"sells": 389,
"priceChangePct": -71.5
}
},
"asOf": 1787097303652,
"cursor": "v1.amun6v2l5lbes.2.mfq3c2y2",
"reason": "subscribe"
}{
"op": "subscribe",
"channel": "token-updates",
"id": "tok-1",
"params": {
"chain": "solana",
"address": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump"
}
}Tokens & pools
Token Updates Stream
Live refresh of the mutable Token Details fields - price, market cap, liquidity, bonding progress, 24h stats. Pushed as they change, at the pace you choose (updatePeriod, 100 ms by default), for one token or a list of up to 50 (100 on a raised limit); fields you already parse from /v1/token.
WS channel: token-updates
Live refresh of the mutable Token Details fields - price, market cap, liquidity, bonding progress, 24h stats. Pushed as they change, at the pace you choose (updatePeriod, 100 ms by default), for one token or a list of up to 50 (100 on a raised limit); fields you already parse from /v1/token.
Token address. Required unless you give
tokens. tokenAddress is accepted as the same parameter (give one of the two). Example: CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpumpA list of 1 to 100
{ "chain", "address" } entries (or { "chain", "tokenAddress" }), instead of chain and address. One subscription, one message per period carrying every token that changed, as "data": [state, ...]. Each token of the list counts as one subscription in your limits, and token-updates holds at most 50 subscriptions per account by default (ask us to raise it, up to 100 per list): a list that does not fit is refused as a whole (RATE_LIMITED, the message says how many fit). since is not available on a list.Milliseconds, 0 to 60000, or
"block"; default 100. Each period delivers the latest state of each token that changed ("block": one message per chain and per 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.Extra sliding windows, among
1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 24h (a list or a comma-separated string). Each state then ends with a windows object carrying one block per window you asked, with the same fields as stats24h. Absent unless you ask. On a tokens list, give windows once, next to the list: it applies to every token. Example: ["5m", "1h"]Each state starts with
chain and address, then tokenAddress (the same token) and poolAddress, the token’s main market whose price the state carries: the pool of /v1/token (for a native coin, its main USD market; null when unknown).The refresh runs server-side through the same engine as
/v1/token, so stats24h carries the identical fields and numbers as the REST snapshot - re-parse events with the code you already wrote. liquidityNative and liquidityUsd are the token’s liquidity, the figure of /v1/token: its most traded markets summed, each counted on its smaller side. pooledBase, pooledQuote, pooledBaseNative and pooledQuoteNative are what sits in the token’s main pool (poolAddress), the pool block of /v1/token with the same values (see /v1/pool for their rules): null while the token is on its launch curve, on majors, stablecoins, wrapped natives and native coins, and when the pool’s indexed reserves are not reliable. They never send a message on their own, periodic states included: they are refreshed with the token’s next message. stats24h.uniqueBuyers and stats24h.uniqueSellers are the distinct wallets whose last buy or last sale falls in the window, across the token’s pools, counted live and refreshed on every event. stats24h.traders is the number of unique wallets that bought or sold in the window, each wallet counted once across the token’s pools, the figure of /v1/token: it is refreshed with every trade of the token and with each periodic state, and it is null when unknown (on majors, stablecoins, wrapped natives and native coins). stats24h.feesNative and stats24h.feesUsd are the fees paid by traders in the window, summed over the token’s pools, in the chain’s native unit and in USD at the same rate as volumeUsd, the figures of /v1/token (null on majors, stablecoins, wrapped natives and native coins). The stream adds three counts the REST snapshot does not carry: stats24h.snipers, stats24h.proTraders and stats24h.smartTraders, the wallets flagged as snipers of the token, as pro traders and as smart traders that traded in the window. Every state carries its chain and address, then the token’s holders and label stats, with the names of /v1/token and /v1/token/security: holdersCount, top10HoldersPct, top25HoldersPct, top50HoldersPct, devHoldingsPct, snipersHoldingsPct, bundlersHoldingsPct, insidersHoldingsPct and proTradersAllTimeCount (defined on the Pulse card), and right after each of the three label shares the number of those wallets still holding the token: snipersCount, bundlersCount and insidersCount, the figures of /v1/token. On Solana all twelve are served, each null when unknown. On EVM chains holdersCount, top10HoldersPct, top25HoldersPct and devHoldingsPct are served, each null when unknown, and top50HoldersPct and the seven label fields are null; these EVM holder figures never send a message on their own, periodic states included: they are refreshed with the token’s next message. A state moved only by these figures is free; on Solana the three counts are refreshed when the token’s holders or label shares move, and with each periodic state. Your first message is the current state ("reason": "subscribe", 1 credit); every 60 s, if anything moved, the full state is sent again for free ("reason": "periodic"), as it is after a hiccup ("reason": "resync"). A change costs 1 credit per token that traded, or had another on-chain event, since your previous message; a token moved only by the native coin’s USD price is free, and a native coin (ETH, BNB, SOL…) costs 1 when its price changed (Billing). windows carries the same sliding windows as the Pulse views, with the fields of stats24h; stats24h is the same whether you ask windows or not, and a window we cannot fill yet is null, never a partial number. A token that /v1/token does not know yet (not indexed yet, or a Solana address with the wrong letter case) is acknowledged and sends nothing until it exists: check the address against /v1/token if no first message comes.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. |
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. |
Resume
Events carry acursor. After a reconnect, a subscribe with "since": "<cursor>" is accepted and starts with the current state: every event is the full state, so nothing needs to be replayed. On a tokens list, subscribe again without since: the first message carries the current state of every token.
{
"op": "subscribe",
"channel": "token-updates",
"id": "tok-1",
"params": {
"chain": "solana",
"address": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump"
}
}
{
"op": "subscribe",
"channel": "token-updates",
"id": "tok-2",
"params": {
"chain": "solana",
"address": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump",
"windows": ["5m", "1h"]
}
}
{
"op": "subscribe",
"channel": "token-updates",
"id": "watchlist",
"params": {
"tokens": [
{ "chain": "solana", "address": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump" },
{ "chain": "evm:8453", "address": "0xb2000000000000000000007bf6d5cbb0e24cb301" }
],
"updatePeriod": 1000
}
}
{
"op": "subscribed",
"id": "tok-1",
"channel": "token-updates",
"updatePeriod": 100
}
{
"op": "event",
"id": "tok-1",
"channel": "token-updates",
"data": {
"chain": "solana",
"address": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump",
"tokenAddress": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump",
"poolAddress": "Ea5SjE2Y6yvCeW5dYTn7PYMuW5ikXkvbGdcmSnXeaLjS",
"priceNative": "0.000000028472524478",
"priceUsd": 0.0000021952461580276,
"marketCapUsd": 2195.24,
"fdvUsd": 2195.24,
"liquidityNative": "30.466812",
"liquidityUsd": 2348.64,
"pooledBase": null,
"pooledQuote": null,
"pooledBaseNative": null,
"pooledQuoteNative": null,
"launchpad": {
"migrated": false,
"bondingProgress": 38.6,
"graduatedAt": null,
"launchpadPoolAddress": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump"
},
"holdersCount": 412,
"top10HoldersPct": 28.4,
"top25HoldersPct": 39.1,
"top50HoldersPct": 47.6,
"devHoldingsPct": 1.9,
"snipersHoldingsPct": 2.2,
"snipersCount": 3,
"bundlersHoldingsPct": null,
"bundlersCount": null,
"insidersHoldingsPct": null,
"insidersCount": null,
"proTradersAllTimeCount": 5,
"stats24h": {
"volumeNative": 217.201948,
"volumeUsd": 16738.29,
"buyVolumeUsd": 8634.47,
"sellVolumeUsd": 8103.82,
"buys": 412,
"sells": 389,
"buyVolumeNative": 112.043901,
"sellVolumeNative": 105.158047,
"txns": 792,
"uniqueBuyers": 318,
"uniqueSellers": 276,
"snipers": 4,
"proTraders": 21,
"smartTraders": 13,
"volumeOrganicNative": 201.403118,
"volumeOrganicUsd": 15521.84,
"buysOrganic": 398,
"sellsOrganic": 377,
"priceChangePct": -71.5,
"traders": 472,
"feesNative": 0.642215931,
"feesUsd": 49.491253
}
},
"asOf": 1787097303652,
"cursor": "v1.amun6v2l5lbes.2.mfq3c2y2",
"reason": "subscribe"
}
{
"op": "event",
"id": "tok-2",
"channel": "token-updates",
"data": {
"chain": "solana",
"address": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump",
"tokenAddress": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump",
"poolAddress": "Ea5SjE2Y6yvCeW5dYTn7PYMuW5ikXkvbGdcmSnXeaLjS",
"priceNative": "0.000000028472524478",
"priceUsd": 0.0000021952461580276,
"marketCapUsd": 2195.24,
"fdvUsd": 2195.24,
"liquidityNative": "30.466812",
"liquidityUsd": 2348.64,
"pooledBase": null,
"pooledQuote": null,
"pooledBaseNative": null,
"pooledQuoteNative": null,
"launchpad": {
"migrated": false,
"bondingProgress": 38.6,
"graduatedAt": null,
"launchpadPoolAddress": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump"
},
"holdersCount": 412,
"top10HoldersPct": 28.4,
"top25HoldersPct": 39.1,
"top50HoldersPct": 47.6,
"devHoldingsPct": 1.9,
"snipersHoldingsPct": 2.2,
"snipersCount": 3,
"bundlersHoldingsPct": null,
"bundlersCount": null,
"insidersHoldingsPct": null,
"insidersCount": null,
"proTradersAllTimeCount": 5,
"stats24h": {
"volumeNative": 217.201948,
"volumeUsd": 16738.29,
"buyVolumeUsd": 8634.47,
"sellVolumeUsd": 8103.82,
"buys": 412,
"sells": 389,
"buyVolumeNative": 112.043901,
"sellVolumeNative": 105.158047,
"txns": 792,
"uniqueBuyers": 318,
"uniqueSellers": 276,
"snipers": 4,
"proTraders": 21,
"smartTraders": 13,
"volumeOrganicNative": 201.403118,
"volumeOrganicUsd": 15521.84,
"buysOrganic": 398,
"sellsOrganic": 377,
"priceChangePct": -71.5,
"traders": 472,
"feesNative": 0.642215931,
"feesUsd": 49.491253
},
"windows": {
"5m": {
"volumeNative": 3.120044,
"volumeUsd": 240.44,
"buyVolumeUsd": 170.32,
"sellVolumeUsd": 70.12,
"buys": 9,
"sells": 4,
"buyVolumeNative": 2.2101,
"sellVolumeNative": 0.909944,
"txns": 13,
"uniqueBuyers": 8,
"uniqueSellers": 4,
"snipers": 0,
"proTraders": 2,
"smartTraders": 1,
"volumeOrganicNative": 3.120044,
"volumeOrganicUsd": 240.44,
"buysOrganic": 9,
"sellsOrganic": 4,
"priceChangePct": 1.9,
"traders": 11,
"feesNative": 0.009847512,
"feesUsd": 0.758879
},
"1h": {
"volumeNative": 41.870312,
"volumeUsd": 3226.63,
"buyVolumeUsd": 1806.48,
"sellVolumeUsd": 1420.15,
"buys": 96,
"sells": 71,
"buyVolumeNative": 23.4417,
"sellVolumeNative": 18.428612,
"txns": 164,
"uniqueBuyers": 74,
"uniqueSellers": 58,
"snipers": 1,
"proTraders": 9,
"smartTraders": 6,
"volumeOrganicNative": 40.130662,
"volumeOrganicUsd": 3092.61,
"buysOrganic": 93,
"sellsOrganic": 69,
"priceChangePct": -4.2,
"traders": 119,
"feesNative": 0.125498763,
"feesUsd": 9.671246
}
}
},
"asOf": 1787097303652,
"cursor": "v1.amun6v2l5lbes.7.mfq3c2y2"
}
{
"op": "event",
"id": "tok-3",
"channel": "token-updates",
"data": {
"chain": "evm:8453",
"address": "0xb2000000000000000000007bf6d5cbb0e24cb301",
"tokenAddress": "0xb2000000000000000000007bf6d5cbb0e24cb301",
"poolAddress": "0x4e3b8f9a5c2d7e1f0a6b9c8d7e6f5a4b3c2d1e0f",
"priceNative": "0.0000312",
"...": "...",
"pooledBase": "1845021",
"pooledQuote": "57.61",
"pooledBaseNative": "57.5646552",
"pooledQuoteNative": "57.61",
"holdersCount": 1840,
"top10HoldersPct": 34.2,
"top25HoldersPct": 48.9,
"top50HoldersPct": null,
"devHoldingsPct": 0.8,
"snipersHoldingsPct": null,
"snipersCount": null,
"bundlersHoldingsPct": null,
"bundlersCount": null,
"insidersHoldingsPct": null,
"insidersCount": null,
"proTradersAllTimeCount": null,
"stats24h": { "volumeUsd": 48210.3, "buys": 312, "sells": 251, "txns": 563, "...": "..." }
},
"asOf": 1787097303652,
"cursor": "v1.amun6v2l5lbes.3.mfq3c2y2"
}
{
"op": "event",
"id": "watchlist",
"channel": "token-updates",
"data": [
{ "chain": "solana", "address": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump", "priceNative": "0.000000028472524478", "...": "..." },
{ "chain": "evm:8453", "address": "0xb2000000000000000000007bf6d5cbb0e24cb301", "priceNative": "0.0000312", "...": "..." }
],
"asOf": 1787097304652
}
Messages
{
"op": "subscribed",
"id": "tok-1",
"channel": "token-updates",
"updatePeriod": 100
}{
"op": "event",
"id": "tok-1",
"channel": "token-updates",
"data": {
"chain": "solana",
"address": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump",
"tokenAddress": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump",
"poolAddress": "Ea5SjE2Y6yvCeW5dYTn7PYMuW5ikXkvbGdcmSnXeaLjS",
"priceNative": "0.000000028472524478",
"priceUsd": 0.0000021952461580276,
"marketCapUsd": 2195.24,
"fdvUsd": 2195.24,
"liquidityUsd": 2348.64,
"pooledBase": null,
"pooledQuote": null,
"pooledBaseNative": null,
"pooledQuoteNative": null,
"launchpad": {
"migrated": false,
"bondingProgress": 38.6,
"graduatedAt": null
},
"stats24h": {
"volumeUsd": 16738.29,
"buys": 412,
"sells": 389,
"priceChangePct": -71.5
}
},
"asOf": 1787097303652,
"cursor": "v1.amun6v2l5lbes.2.mfq3c2y2",
"reason": "subscribe"
}{
"op": "subscribe",
"channel": "token-updates",
"id": "tok-1",
"params": {
"chain": "solana",
"address": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump"
}
}Ack
type:object
Server acknowledgement: the subscription is live.
Update
type:object
Server push frame (Update).
Subscribe
type:object
Client frame opening the subscription (additive, ack is explicit).