Screener Pools Stream

Messages

{
  "op": "event",
  "id": "trend-base",
  "channel": "screener-pools",
  "data": {
    "type": "snapshot",
    "seq": 0,
    "epoch": "mun6v2l5lbes",
    "rows": [
      {
        "chain": "evm:8453",
        "address": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump",
        "name": "Pump Kitten",
        "symbol": "PKIT",
        "priceUsd": 0.0000047,
        "marketCapUsd": 4712.25,
        "liquidityUsd": 12637.5,
        "pool": {
          "address": "Ea5SjE2Y6yvCeW5dYTn7PYMuW5ikXkvbGdcmSnXeaLjS",
          "type": "PUMP_FUN",
          "factory": "pumpfun",
          "quoteAddress": "So11111111111111111111111111111111111111112",
          "quoteSymbol": "SOL"
        },
        "bondingProgress": 3.5,
        "migrated": false,
        "createdAt": 1790539700000,
        "txns": 12,
        "buys": 9,
        "sells": 3,
        "volumeUsd": 1840.2,
        "feesUsd": 23.1,
        "priceChangePct": 12.4,
        "...": "...",
        "rank": 0
      }
    ]
  },
  "asOf": 1790539767146,
  "cursor": "v1.amun6v2l5lbes.2.mfq3c2y2",
  "reason": "subscribe"
}

{
  "op": "event",
  "id": "trend-base",
  "channel": "screener-pools",
  "data": {
    "type": "delta",
    "seq": 1,
    "prev": 0,
    "epoch": "mun6v2l5lbes",
    "enter": [
      {
        "chain": "solana",
        "address": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump",
        "rank": 17,
        "...": "..."
      }
    ],
    "update": [
      {
        "key": "solana:DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
        "priceUsd": 0.0000148,
        "windows": {
          "1h": {
            "volumeUsd": 96402.1,
            "txns": 790
          }
        }
      }
    ],
    "leave": [
      "solana:7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr"
    ]
  },
  "asOf": 1790539767301,
  "cursor": "v1.amun6v2l5lbes.5.mfq3c4a1"
}

WS channel: screener-pools Enabled on your key on request: contact us. The live market screener with one row per pool: the full list on subscribe, then every pool that enters, changes or leaves, as it happens. Same parameters, filters and messages as the Screener Stream, which gives one row per token. Use it when the pool is what you track: a pool-level screener, liquidity tooling, or a view where the same token can appear once per pool. It is the closest shape to the rows of REST /v1/screener, which are pools too.

What differs from the Screener Stream

	`screener`	`screener-pools`
One row	per token	per pool
Row `key`	`<chain>:<token address>`	`<chain>:<pool address>`
`pool`	the token’s most active pool	the pool of the row
`pools`	every known pool of the token	not present
Counters and windows (`txns`, `volumeUsd`, `windows`…)	of the token	of the pool
Wallet counts per window (`windows.<w>.uniqueBuyers`, `uniqueSellers`, `traders`, `snipers`, `proTraders`)	across the token’s pools	of the pool
Holders (`holdersCount`, `top10HoldersPct`, `devHoldingsPct`)	of the token	of the token: every pool row of a token carries the same `holdersCount` and `top10HoldersPct`; `devHoldingsPct` is the share of the row’s own `creator.address` (`null` on a pool whose creator is not the token’s)
In the list while	one of the token’s pools passes the quality floor	this pool passes it

Everything else is identical: mixing chains, timeframe, the named sorts (trending, volume, marketCap, createdAt) and the numeric fields, limit, sortOrder, updatePeriod, windows, the filter tree and the flat REST filters, the snapshot then delta delivery, rank and order, the free snapshot every 60 s, since, errors and close codes. The Screener Stream page is the reference for each of them.

Parameters

string[]

required

1 to 8 public chain ids, evm:<id> or solana. EVM chains and Solana can be mixed in one view. Example: ["evm:8453"]

string

The window the view works on, one of 1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 24h. Default 24h. Same rules as the Screener Stream.

string

trending (default), volume (alias top), marketCap, createdAt, or any numeric card field. A bare counter reads the timeframe window.

string

asc or desc. Default desc.

number

View size, 1 to 100. Default 50.

object

A filter tree, same grammar and same fields as the Pulse Stream; bare counters read the timeframe window.

integer

Milliseconds, 0 to 60000, default 100: at most one delta per period. Same rules as the Screener Stream; the ack carries the value applied.

string[]

The rolling windows to include in each row, among 1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 24h. Default: the timeframe. Same rules as the Screener Stream.

There is no model parameter: the list is the active market.

Applying a delta

Remove every key listed in leave.
Apply every update: the fields present replace those of the row.
Insert every row of enter at its rank, in the order given.
If order is present, arrange your rows in that order.

A snapshot replaces everything you hold for the view.

Billing

1 credit per message delivered. The snapshot of a subscription ("reason": "subscribe") costs 1, whatever its size; every delta costs 1, whatever it carries. Snapshots sent on our own after that first one ("reason": "periodic" every 60 s, "reason": "resync" after a hiccup) and deltas flagged "replay": true are free; the snapshot sent when you resume with since costs 1, like the one of a new subscription. The connection is free. A longer updatePeriod means fewer messages, and fewer credits. GET /v1/usage/breakdown reports this channel under WS screener-pools, where requests is the number of messages delivered.

{
  "op": "subscribe",
  "channel": "screener-pools",
  "id": "top-5m-base",
  "params": {
    "chains": ["evm:8453"],
    "timeframe": "5m",
    "sortBy": "volume",
    "limit": 25,
    "filters": {
      "liquidityUsd": { "gte": 25000 }
    }
  }
}

{
  "op": "subscribed",
  "id": "top-5m-base",
  "channel": "screener-pools",
  "updatePeriod": 100
}

{
  "op": "event",
  "id": "top-5m-base",
  "channel": "screener-pools",
  "data": {
    "type": "snapshot",
    "seq": 0,
    "epoch": "mun6v2l5lbes",
    "rows": [
      {
        "chain": "evm:8453",
        "address": "0x532f27101965dd16442e59d40670faf5ebb142e4",
        "symbol": "BRETT",
        "pool": {
          "address": "0x76bf0abd20f1e0155ce40a62615a90a709a6c3d8",
          "type": "UNISWAP_V3",
          "factory": null,
          "quoteAddress": "0x4200000000000000000000000000000000000006",
          "quoteSymbol": "WETH"
        },
        "liquidityUsd": 4120340.8,
        "marketCapUsd": 612044120.5,
        "windows": {
          "5m": { "volumeUsd": 48210.3, "feesUsd": 144.6, "buys": 31, "sells": 27, "txns": 58, "uniqueBuyers": 24, "uniqueSellers": 19, "traders": 41, "snipers": 0, "proTraders": 6, "priceChangePct": 0.4 }
        },
        "…": "…"
      }
    ]
  },
  "asOf": 1790539767146,
  "cursor": "v1.amun6v2l5lbes.3.mfq3c2y2"
}

{
  "op": "event",
  "id": "top-5m-base",
  "channel": "screener-pools",
  "data": {
    "type": "delta",
    "seq": 1,
    "prev": 0,
    "epoch": "mun6v2l5lbes",
    "enter": [],
    "update": [
      { "key": "evm:8453:0x76bf0abd20f1e0155ce40a62615a90a709a6c3d8", "priceUsd": 0.0621, "windows": { "5m": { "volumeUsd": 49102.9, "buys": 32, "txns": 59, "uniqueBuyers": 25, "traders": 42 } } }
    ],
    "leave": [],
    "order": ["evm:8453:0x76bf0abd20f1e0155ce40a62615a90a709a6c3d8", "evm:8453:0x3c5d7e9f1a2b4c6d8e0f1a3b5c7d9e1f2a4b6c8d"]
  },
  "asOf": 1790539768020,
  "cursor": "v1.amun6v2l5lbes.8.mfq3c5k7"
}

Messages

{
  "op": "event",
  "id": "trend-base",
  "channel": "screener-pools",
  "data": {
    "type": "snapshot",
    "seq": 0,
    "epoch": "mun6v2l5lbes",
    "rows": [
      {
        "chain": "evm:8453",
        "address": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump",
        "name": "Pump Kitten",
        "symbol": "PKIT",
        "priceUsd": 0.0000047,
        "marketCapUsd": 4712.25,
        "liquidityUsd": 12637.5,
        "pool": {
          "address": "Ea5SjE2Y6yvCeW5dYTn7PYMuW5ikXkvbGdcmSnXeaLjS",
          "type": "PUMP_FUN",
          "factory": "pumpfun",
          "quoteAddress": "So11111111111111111111111111111111111111112",
          "quoteSymbol": "SOL"
        },
        "bondingProgress": 3.5,
        "migrated": false,
        "createdAt": 1790539700000,
        "txns": 12,
        "buys": 9,
        "sells": 3,
        "volumeUsd": 1840.2,
        "feesUsd": 23.1,
        "priceChangePct": 12.4,
        "...": "...",
        "rank": 0
      }
    ]
  },
  "asOf": 1790539767146,
  "cursor": "v1.amun6v2l5lbes.2.mfq3c2y2",
  "reason": "subscribe"
}

{
  "op": "event",
  "id": "trend-base",
  "channel": "screener-pools",
  "data": {
    "type": "delta",
    "seq": 1,
    "prev": 0,
    "epoch": "mun6v2l5lbes",
    "enter": [
      {
        "chain": "solana",
        "address": "CBZq5ycLcr6mnYvjFTPuYSuhgS3ujsiTrT4sqatBpump",
        "rank": 17,
        "...": "..."
      }
    ],
    "update": [
      {
        "key": "solana:DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
        "priceUsd": 0.0000148,
        "windows": {
          "1h": {
            "volumeUsd": 96402.1,
            "txns": 790
          }
        }
      }
    ],
    "leave": [
      "solana:7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr"
    ]
  },
  "asOf": 1790539767301,
  "cursor": "v1.amun6v2l5lbes.5.mfq3c4a1"
}

Ack

type:object

Server acknowledgement: the subscription is live.

Snapshot

type:object

The complete view, in order: right after the ack ("reason": "subscribe", 1 credit), every 60 s if the view moved (periodic, free) and whenever the view has to be replaced (resync, free).

Delta

type:object

Each change of the view, at most one per updatePeriod: 1 credit per message.

type:object

Client frame opening the subscription (additive, ack is explicit).

Getting started

Market data

Token lists

Wallets

What differs from the Screener Stream

Parameters

Applying a delta

Billing

​What differs from the Screener Stream

​Parameters

​Applying a delta

​Billing

What differs from the Screener Stream

Parameters

Applying a delta

Billing