Messages
{
"op": "subscribed",
"id": "pool-1",
"channel": "pool-updates",
"updatePeriod": 100
}{
"op": "event",
"id": "pool-1",
"channel": "pool-updates",
"data": {
"chain": "solana",
"pool": "BqnpCdDLPV2pFdAaLnVidmn3G93RP2p5oRdGEY2sJGez",
"tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"poolAddress": "BqnpCdDLPV2pFdAaLnVidmn3G93RP2p5oRdGEY2sJGez",
"priceNative": "0.000000027894474571",
"priceUsd": 0.00000288045,
"marketCapUsd": 253463983.91,
"liquidityNative": "722.161187853",
"liquidityUsd": 74572.08,
"pooledBase": "25889283417.82",
"pooledQuote": "722.161187853",
"pooledBaseNative": "722.1679579597919",
"pooledQuoteNative": "722.161187853",
"bondingProgress": null,
"migrated": false,
"stats": {
"5m": {
"volumeNative": 0.489206931,
"volumeUsd": 50.51,
"buyVolumeUsd": 41.31,
"sellVolumeUsd": 9.2,
"buys": 6,
"sells": 2,
"buyVolumeNative": 0.400091205,
"sellVolumeNative": 0.089115726,
"txns": 8,
"volumeOrganicNative": 0.489206931,
"volumeOrganicUsd": 50.51,
"buysOrganic": 6,
"sellsOrganic": 2,
"priceChangePct": 0.42,
"traders": 7,
"feesNative": 0.000704,
"feesUsd": 0.072687,
"poolFeesNative": 0.004892069
},
"1h": {
"volumeNative": 2.221187931,
"volumeUsd": 229.36,
"buyVolumeUsd": 229.36,
"sellVolumeUsd": 0,
"buys": 27,
"sells": 0,
"buyVolumeNative": 2.221187931,
"sellVolumeNative": 0,
"txns": 27,
"volumeOrganicNative": 1.896568223,
"volumeOrganicUsd": 195.84,
"buysOrganic": 20,
"sellsOrganic": 0,
"priceChangePct": 1.58,
"traders": 15,
"feesNative": 0.002376526,
"feesUsd": 0.2454,
"poolFeesNative": 0.022211894
},
"24h": {
"volumeNative": 7.170081239,
"volumeUsd": 740.39,
"buyVolumeUsd": 242.11,
"sellVolumeUsd": 498.28,
"buys": 28,
"sells": 48,
"buyVolumeNative": 2.344647931,
"sellVolumeNative": 4.825433308,
"txns": 76,
"volumeOrganicNative": 6.512701056,
"volumeOrganicUsd": 672.51,
"buysOrganic": 21,
"sellsOrganic": 45,
"priceChangePct": -1.78,
"traders": 41,
"feesNative": 0.006465399,
"feesUsd": 0.667624,
"poolFeesNative": 0.072148996
}
}
},
"asOf": 1788168160758,
"cursor": "v1.amun6v2l5lbes.2.mfq3c2y2",
"reason": "subscribe"
}{
"op": "subscribe",
"channel": "pool-updates",
"id": "pool-1",
"params": {
"chain": "solana",
"pool": "BqnpCdDLPV2pFdAaLnVidmn3G93RP2p5oRdGEY2sJGez"
}
}Tokens & pools
Pool Updates Stream
Live refresh of a market’s mutable fields - price, market cap, liquidity, bonding progress, windowed stats. Instant price on every trade of the pool, at the pace you choose (updatePeriod, 100 ms by default), for one pool or a list of up to 50 (100 on a raised limit); fields you already parse from /v1/pool/data.
WS channel: pool-updates
Live refresh of a market’s mutable fields - price, market cap, liquidity, bonding progress, windowed stats. The price moves on every trade of the pool. Events are pushed as soon as something changes, grouped by your updatePeriod (100 ms by default: a burst of trades inside one period arrives as one event carrying the latest values), and deduplicated - you only receive an event when something actually changed. Every 60 s, if anything moved, the full state is sent again for free.
Pool (market) address. Required unless you give
pools. poolAddress is accepted as the same parameter (give one of the two). Example: BqnpCdDLPV2pFdAaLnVidmn3G93RP2p5oRdGEY2sJGezA list of 1 to 100
{ "chain", "pool" } entries (or { "chain", "poolAddress" }), instead of chain and pool. One subscription, one message per period carrying every pool that changed, as "data": [state, ...]. Each pool of the list counts as one subscription in your limits, and pool-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 pool 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 a window of stats. Absent unless you ask. On a pools list, give windows once, next to the list: it applies to every pool. Example: ["1m", "15m"]Each state starts with
chain and pool, then tokenAddress (the pool’s token, the token.address of /v1/pool/data; null when unknown) and poolAddress (the same pool as pool).bondingProgress and migrated are the market’s launchpad state, the same values as on /v1/pool/data: the progress of a bonding curve, or the progress toward the liquidity or market cap goal of a launchpad with no bonding curve (Clanker, Bankr, Zora…) on the pool it launched its token into, null on any other pool, and migrated: true once a launchpad pool graduated. On a launchpad whose goal is a market cap in USD, both follow the price of the native coin.pooledBase, pooledQuote, pooledBaseNative and pooledQuoteNative are what sits in the pool, the same fields and values as on /v1/pool/data (see /v1/pool for their rules): null on a launch curve, on a concentrated-liquidity pool whose indexed reserves are not reliable, and before the pool ever held anything. They never send a message on their own, periodic states included: a state moved only by them is not sent, and the pool’s next message carries their latest values.migratedTo and migratedFrom link the two pools of a launchpad migration, the same values as on /v1/pool/data: on a bonding curve that migrated, the address of the pool it migrated to; on the pool a migration landed in, the address of its bonding curve. Both are null on every other pool. A bonding curve’s frame carries migratedTo as soon as the curve migrates: subscribe to that pool to keep following the market.The refresh runs server-side through the same engine as
/v1/pool/data, so stats carries the identical 5m/1h/24h windows and field names as the REST snapshot - re-parse events with the code you already wrote. In each window, uniqueBuyers, uniqueSellers and traders are the distinct wallets whose last buy, last sale or last trade falls in the window, counted live and refreshed on every event of the pool. feesNative and feesUsd are the fees paid by the pool’s traders in the window, in the chain’s native unit and in USD at the same rate as volumeUsd, the figures of /v1/pool/data; Solana pools add poolFeesNative, the fees collected by the pool itself. The stream adds three counts per window the REST snapshot does not carry: snipers, proTraders and 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 pool. Your first message is the current state ("reason": "subscribe", 1 credit); the full states sent again on our own ("reason": "periodic" every 60 s, "reason": "resync" after a hiccup) are free; a change costs 1 credit per pool that traded, or had another on-chain event, since your previous message, and is free otherwise (Billing). windows carries the same sliding windows as the Pulse views, with the fields of a stats window; stats itself always keeps 5m, 1h and 24h, and a window we cannot fill yet is null, never a partial number. A pool that /v1/pool/data 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/pool/data 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 pools list, subscribe again without since: the first message carries the current state of every pool.
{
"op": "subscribe",
"channel": "pool-updates",
"id": "pool-1",
"params": {
"chain": "solana",
"pool": "BqnpCdDLPV2pFdAaLnVidmn3G93RP2p5oRdGEY2sJGez"
}
}
{
"op": "subscribe",
"channel": "pool-updates",
"id": "pool-2",
"params": {
"chain": "solana",
"pool": "BqnpCdDLPV2pFdAaLnVidmn3G93RP2p5oRdGEY2sJGez",
"windows": ["1m", "15m"]
}
}
{
"op": "subscribe",
"channel": "pool-updates",
"id": "pools-1",
"params": {
"pools": [
{ "chain": "solana", "pool": "BqnpCdDLPV2pFdAaLnVidmn3G93RP2p5oRdGEY2sJGez" },
{ "chain": "evm:8453", "pool": "0x4c36388be6f416a29c8d8eee81c771ce6be14b18" }
],
"updatePeriod": 500
}
}
{
"op": "subscribed",
"id": "pool-1",
"channel": "pool-updates",
"updatePeriod": 100
}
{
"op": "event",
"id": "pool-1",
"channel": "pool-updates",
"data": {
"chain": "solana",
"pool": "BqnpCdDLPV2pFdAaLnVidmn3G93RP2p5oRdGEY2sJGez",
"tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"poolAddress": "BqnpCdDLPV2pFdAaLnVidmn3G93RP2p5oRdGEY2sJGez",
"priceNative": "0.000000027894474571",
"priceUsd": 0.00000288045,
"marketCapUsd": 253463983.91,
"liquidityNative": "722.161187853",
"liquidityUsd": 74572.08,
"pooledBase": "25889283417.82",
"pooledQuote": "722.161187853",
"pooledBaseNative": "722.1679579597919",
"pooledQuoteNative": "722.161187853",
"bondingProgress": null,
"migrated": false,
"migratedTo": null,
"migratedFrom": null,
"stats": {
"5m": {
"volumeNative": 0.489206931,
"volumeUsd": 50.51,
"buyVolumeUsd": 41.31,
"sellVolumeUsd": 9.2,
"buys": 6,
"sells": 2,
"buyVolumeNative": 0.400091205,
"sellVolumeNative": 0.089115726,
"txns": 8,
"uniqueBuyers": 5,
"uniqueSellers": 2,
"snipers": 1,
"proTraders": 2,
"smartTraders": 1,
"volumeOrganicNative": 0.489206931,
"volumeOrganicUsd": 50.51,
"buysOrganic": 6,
"sellsOrganic": 2,
"priceChangePct": 0.42,
"traders": 7,
"feesNative": 0.000704,
"feesUsd": 0.072687,
"poolFeesNative": 0.004892069
},
"1h": {
"volumeNative": 2.221187931,
"volumeUsd": 229.36,
"buyVolumeUsd": 229.36,
"sellVolumeUsd": 0,
"buys": 27,
"sells": 0,
"buyVolumeNative": 2.221187931,
"sellVolumeNative": 0,
"txns": 27,
"uniqueBuyers": 15,
"uniqueSellers": 0,
"snipers": 2,
"proTraders": 3,
"smartTraders": 2,
"volumeOrganicNative": 1.896568223,
"volumeOrganicUsd": 195.84,
"buysOrganic": 20,
"sellsOrganic": 0,
"priceChangePct": 1.58,
"traders": 15,
"feesNative": 0.002376526,
"feesUsd": 0.2454,
"poolFeesNative": 0.022211894
},
"24h": {
"volumeNative": 7.170081239,
"volumeUsd": 740.39,
"buyVolumeUsd": 242.11,
"sellVolumeUsd": 498.28,
"buys": 28,
"sells": 48,
"buyVolumeNative": 2.344647931,
"sellVolumeNative": 4.825433308,
"txns": 76,
"uniqueBuyers": 22,
"uniqueSellers": 31,
"snipers": 3,
"proTraders": 6,
"smartTraders": 4,
"volumeOrganicNative": 6.512701056,
"volumeOrganicUsd": 672.51,
"buysOrganic": 21,
"sellsOrganic": 45,
"priceChangePct": -1.78,
"traders": 41,
"feesNative": 0.006465399,
"feesUsd": 0.667624,
"poolFeesNative": 0.072148996
}
}
},
"asOf": 1788168160758,
"cursor": "v1.amun6v2l5lbes.2.mfq3c2y2",
"reason": "subscribe"
}
{
"op": "event",
"id": "pool-2",
"channel": "pool-updates",
"data": {
"chain": "solana",
"pool": "BqnpCdDLPV2pFdAaLnVidmn3G93RP2p5oRdGEY2sJGez",
"tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"poolAddress": "BqnpCdDLPV2pFdAaLnVidmn3G93RP2p5oRdGEY2sJGez",
"priceNative": "0.000000027894474571",
"...": "...",
"stats": { "5m": { "...": "..." }, "1h": { "...": "..." }, "24h": { "...": "..." } },
"windows": {
"1m": {
"volumeNative": 0.120034,
"volumeUsd": 12.39,
"buyVolumeUsd": 12.39,
"sellVolumeUsd": 0,
"buys": 2,
"sells": 0,
"buyVolumeNative": 0.120034,
"sellVolumeNative": 0,
"txns": 2,
"uniqueBuyers": 2,
"uniqueSellers": 0,
"snipers": 0,
"proTraders": 1,
"smartTraders": 1,
"volumeOrganicNative": 0.120034,
"volumeOrganicUsd": 12.39,
"buysOrganic": 2,
"sellsOrganic": 0,
"priceChangePct": 0.11,
"traders": 2,
"feesNative": 0.000176,
"feesUsd": 0.018167,
"poolFeesNative": 0.00120034
},
"15m": {
"volumeNative": 1.004811204,
"volumeUsd": 103.75,
"buyVolumeUsd": 89.85,
"sellVolumeUsd": 13.9,
"buys": 13,
"sells": 3,
"buyVolumeNative": 0.870204,
"sellVolumeNative": 0.134607204,
"txns": 16,
"uniqueBuyers": 9,
"uniqueSellers": 3,
"snipers": 1,
"proTraders": 2,
"smartTraders": 1,
"volumeOrganicNative": 0.93188,
"volumeOrganicUsd": 96.22,
"buysOrganic": 11,
"sellsOrganic": 3,
"priceChangePct": 0.87,
"traders": 11,
"feesNative": 0.001408,
"feesUsd": 0.145381,
"poolFeesNative": 0.01004811
}
}
},
"asOf": 1788168161758,
"cursor": "v1.amun6v2l5lbes.4.mfq3c2y2"
}
Messages
{
"op": "subscribed",
"id": "pool-1",
"channel": "pool-updates",
"updatePeriod": 100
}{
"op": "event",
"id": "pool-1",
"channel": "pool-updates",
"data": {
"chain": "solana",
"pool": "BqnpCdDLPV2pFdAaLnVidmn3G93RP2p5oRdGEY2sJGez",
"tokenAddress": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"poolAddress": "BqnpCdDLPV2pFdAaLnVidmn3G93RP2p5oRdGEY2sJGez",
"priceNative": "0.000000027894474571",
"priceUsd": 0.00000288045,
"marketCapUsd": 253463983.91,
"liquidityNative": "722.161187853",
"liquidityUsd": 74572.08,
"pooledBase": "25889283417.82",
"pooledQuote": "722.161187853",
"pooledBaseNative": "722.1679579597919",
"pooledQuoteNative": "722.161187853",
"bondingProgress": null,
"migrated": false,
"stats": {
"5m": {
"volumeNative": 0.489206931,
"volumeUsd": 50.51,
"buyVolumeUsd": 41.31,
"sellVolumeUsd": 9.2,
"buys": 6,
"sells": 2,
"buyVolumeNative": 0.400091205,
"sellVolumeNative": 0.089115726,
"txns": 8,
"volumeOrganicNative": 0.489206931,
"volumeOrganicUsd": 50.51,
"buysOrganic": 6,
"sellsOrganic": 2,
"priceChangePct": 0.42,
"traders": 7,
"feesNative": 0.000704,
"feesUsd": 0.072687,
"poolFeesNative": 0.004892069
},
"1h": {
"volumeNative": 2.221187931,
"volumeUsd": 229.36,
"buyVolumeUsd": 229.36,
"sellVolumeUsd": 0,
"buys": 27,
"sells": 0,
"buyVolumeNative": 2.221187931,
"sellVolumeNative": 0,
"txns": 27,
"volumeOrganicNative": 1.896568223,
"volumeOrganicUsd": 195.84,
"buysOrganic": 20,
"sellsOrganic": 0,
"priceChangePct": 1.58,
"traders": 15,
"feesNative": 0.002376526,
"feesUsd": 0.2454,
"poolFeesNative": 0.022211894
},
"24h": {
"volumeNative": 7.170081239,
"volumeUsd": 740.39,
"buyVolumeUsd": 242.11,
"sellVolumeUsd": 498.28,
"buys": 28,
"sells": 48,
"buyVolumeNative": 2.344647931,
"sellVolumeNative": 4.825433308,
"txns": 76,
"volumeOrganicNative": 6.512701056,
"volumeOrganicUsd": 672.51,
"buysOrganic": 21,
"sellsOrganic": 45,
"priceChangePct": -1.78,
"traders": 41,
"feesNative": 0.006465399,
"feesUsd": 0.667624,
"poolFeesNative": 0.072148996
}
}
},
"asOf": 1788168160758,
"cursor": "v1.amun6v2l5lbes.2.mfq3c2y2",
"reason": "subscribe"
}{
"op": "subscribe",
"channel": "pool-updates",
"id": "pool-1",
"params": {
"chain": "solana",
"pool": "BqnpCdDLPV2pFdAaLnVidmn3G93RP2p5oRdGEY2sJGez"
}
}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).