Skip to main content
GET
GET /v1/pulse/pools · 1 credit
One row per pool. Live: the pulse-pools stream channel keeps the same rows up to date: the full list on subscribe, then every row that enters, changes or leaves.
The launchpad lifecycle columns of GET /v1/pulse (new, bonding, graduated) with one row per pool: each row is the market the column shows for its token, with the token’s identity, price, liquidity, market cap, the counters of the column and the token’s card (launchpad and lifecycle, links, creator, holders, taxes and flags, all-time high). Same lists, parameters, filter tree, sorts, risk, windows and meta as GET /v1/pulse, and that page is the reference for each of them.
address is the token and pool.address the pool of the row; tokenAddress and poolAddress name the two explicitly (Identity fields). A row has no pools list: on GET /v1/pulse, pools lists the token’s pools we follow.
liquidityNative and liquidityUsd are the pool’s own liquidity, and liquidityMin, liquidityMax and a sort on liquidity read them; on GET /v1/pulse they are the token’s liquidity.
windows gives the rolling figures of the row’s own pool, one entry per window you list among 1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h and 24h (windows=5m,1h), with the same fields as on GET /v1/pulse; the wallet counts are the pool’s wallets. Filters and sorts on windows.<window>.* read these figures of the row’s own pool, as on the pulse-pools stream (on GET /v1/pulse they read the token’s figures, summed over its pools).

Authorizations

​
Authorization
string
header
required

Your raw API key (not needed on the demo server).

Query Parameters

​
view

new | bonding | graduated (migrated is accepted for graduated). Required unless model is given.

Available options:
new
​
model

Same as view, the parameter name of the pulse-pools stream channel; pass one of the two.

Available options:
new
​
chains
string
required

CSV of chain ids (≤8).

​
limit
integer
default:30

1-100, default 30.

Required range: 1 <= x <= 100
​
sortBy
string

Any numeric card field, e.g. createdAt, marketCapUsd, holdersCount, top10HoldersPct, risk.buyTaxBps, marketCapAthUsd, windows.1h.volumeUsd, windows.1m.txns (default: the list's own key: createdAt on new, bondingProgress on bonding, graduatedAt on graduated)

​
sortOrder
string

asc | desc (default desc)

​
filters
string

Filter tree as URL-encoded JSON: {"field":{"op":value}} combined with AND, OR, NOT. Same grammar and field names as the pulse stream. Operators: equals, not, in, gt, gte, lt, lte, contains, startsWith, endsWith. Keywords: {"OR":[{"name":{"contains":"pepe"}},{"symbol":{"contains":"pepe"}}]}; creator: {"creator.address":{"equals":"0x..."}}

​
windows

Rolling windows among 1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 24h, comma-separated or with the parameter repeated: each row then carries a windows block for its own pool, one entry per window, in window order. Absent or empty: no block.

​
ageMin
number

Minutes (graduated: since the graduation)

Required range: x >= 0
​
ageMax
number

Minutes (graduated: since the graduation)

Required range: x >= 0
​
liquidityMin
number

USD

Required range: x >= 0
​
liquidityMax
number

USD

Required range: x >= 0
​
marketCapMin
number

USD

Required range: x >= 0
​
marketCapMax
number

USD

Required range: x >= 0
​
bondingMin
number

Percent of the launchpad bar, 0 to 100

Required range: 0 <= x <= 100
​
bondingMax
number

Percent of the launchpad bar, 0 to 100

Required range: 0 <= x <= 100
​
volumeMin
number

USD, the card counter (volumeUsd)

Required range: x >= 0
​
volumeMax
number

USD, the card counter (volumeUsd)

Required range: x >= 0
​
txnsMin
integer

The card counter (txns)

Required range: x >= 0
​
txnsMax
integer

The card counter (txns)

Required range: x >= 0
​
feesMin
number

USD, the card counter (feesUsd)

Required range: x >= 0
​
feesMax
number

USD, the card counter (feesUsd)

Required range: x >= 0
​
socials
string

CSV: any|twitter|telegram|website

​
factories
string

CSV of launchpad keys (pool.factory, see /v1/meta/factories)

​
dexes
string

CSV of venue keys (see dexesByChain on /v1/meta/factories): markets with no launchpad on these venues; with factories, either side

​
isOG
boolean

first token with this ticker on the chain

​
labeledDev

true or 1: only tokens whose creator is a labeled person (creator.labeled); false or 0: no filter

Available options:
true

Response

200

Standard { data, meta } envelope.