Pulse board API
GET/chains/:chain/pulse
The chain's board of launches: fresh launches, bonding curves close to graduating, and fresh graduations, filtered and sorted. A snapshot at most a few seconds old; follow it with the pulse channel.
Parameters
| Name | In | Type | Default | Allowed values |
|---|---|---|---|---|
chain | path | string | required | evm:56 (BSC), solana, evm:8453 (Base), evm:4663 (Robinhood Chain) or evm:1 (Ethereum) |
view | query | string | new | new, graduating, graduated |
marketCapUsd | query | string | any | A range min..max, bounds included, either side empty: 5000... Every range key works so: see Pulse |
age | query | string | any | A range of seconds since createdAt: ..600 is the last 10 minutes |
launchpad | query | string | all | Comma-separated, any of them. BSC: fourmeme, flap, genius; Solana: pumpfun, letsbonk, raydium-launchlab, meteora-dbc; Base: doppler, zora, clanker, virtuals, o1, basestonk, flaunch, rwagmi; Robinhood Chain: flap, doppler, pons, pools-trade, torch, frontier; Ethereum: clanker, stockereum |
has | query | string | none | Comma-separated, every one of them: logo, website, twitter, telegram, discord |
keywords | query | string | none | Comma-separated: the symbol or name contains any of them, case-insensitive |
excludeKeywords | query | string | none | Comma-separated: the symbol or name contains none of them |
sort | query | string | createdAt, progress or graduatedAt, by view | Any range key, or createdAt, graduatedAt, latestTradeAt |
order | query | string | desc | desc, asc. Nulls sort last either way; ties break by address |
limit | query | integer | 50 | 1–100 |
offset | query | integer | 0 | 0 or more |
Response
| Field | Type | Meaning |
|---|---|---|
chain, view, total, updatedAt | string, string, number, number | The request; board tokens that match the filters before limit and offset; when the board was built, unix ms. |
tokens[] | array | The page, sorted. |
address, symbol, name, logo | string, string | null, string | null, string | null | The token, and its logo's absolute URL. |
launchpad, pool, createdAt, creator | string, string | null, number, string | The launch protocol, the pool it launched into, the launch (unix ms) and the wallet that made it. |
socials | object | From the token's metadata document: https:// URLs or null. |
priceUsd, marketCapUsd, liquidityUsd | number | null | As on the token page: the chart pool's latest priced close, × circulating supply, and its real balances. |
progress, graduatedAt, latestTradeAt | number | null | A bonding curve's share of its sellable supply sold (0 to 1), when the curve completed, and the token's newest swap. |
creatorNetShare | number | null | What the creator bought minus sold through swaps of the token, as a share of total supply. Transfers do not count. |
sniperCount, sniperNetShare | number | null | Wallets (the creator excluded) that bought in the launch block or the 4 after it (slots on Solana), and their bought minus sold as a share of supply. |
windows | { 5m, 1h, 6h, 24h } | As on the token page. |
Example
Captured 2026-09-28 18:03 UTC on a test instance, trimmed to 1 token.
curl -s -H 'Authorization: Bearer <key>' 'https://app.aurelia.build/api/chains/evm:56/pulse?view=new&limit=1'
{
"chain": "evm:56",
"view": "new",
"total": 2,
"updatedAt": 1790618579441,
"tokens": [
{
"address": "0x5eed00000000000000000000000000000000c444",
"symbol": "NEWT3",
"name": "Newt Three",
"logo": "http://localhost:7170/logos/evm:56/0x5eed00000000000000000000000000000000c444?v=cccccccccccc",
"launchpad": "fourmeme",
"pool": "0xed80c90b543397140863599d535a4427ed378a30e094a01a025bea52acb9fcc7",
"createdAt": 1790548061920,
"creator": "0x0f325bd174c70440fa62c31dce9f69d54baf717e",
"socials": {
"website": null,
"twitter": null,
"telegram": null,
"discord": null,
"others": {}
},
"priceUsd": 0.000015000000000000002,
"marketCapUsd": 15000.000000000002,
"liquidityUsd": null,
"progress": 0.18,
"graduatedAt": null,
"latestTradeAt": 1790548064920,
"creatorNetShare": 0,
"sniperCount": 2,
"sniperNetShare": 0.022,
"windows": {
"5m": {
"priceChange": 0,
"volumeUsd": 0,
"buyVolumeUsd": 0,
"sellVolumeUsd": 0,
"trades": 0,
"buys": 0,
"sells": 0,
"traders": 0,
"buyers": 0,
"sellers": 0,
"feesPaidUsd": null
},
"1h": {
"priceChange": 0,
"volumeUsd": 0,
"buyVolumeUsd": 0,
"sellVolumeUsd": 0,
"trades": 0,
"buys": 0,
"sells": 0,
"traders": 0,
"buyers": 0,
"sellers": 0,
"feesPaidUsd": null
},
"6h": {
"priceChange": 0,
"volumeUsd": 0,
"buyVolumeUsd": 0,
"sellVolumeUsd": 0,
"trades": 0,
"buys": 0,
"sells": 0,
"traders": 0,
"buyers": 0,
"sellers": 0,
"feesPaidUsd": null
},
"24h": {
"priceChange": null,
"volumeUsd": 330,
"buyVolumeUsd": 330,
"sellVolumeUsd": 0,
"trades": 2,
"buys": 2,
"sells": 0,
"traders": 2,
"buyers": 2,
"sellers": 0,
"feesPaidUsd": null
}
}
}
]
}
Notes
- A snapshot: each view's board is rebuilt at most every second, and a request answers at once from the latest one. The first request for a view after a quiet spell of over 5 minutes waits while its board is built.
newholds the newest 1,000 launches of the last 24 h that have not graduated;graduatingthe 500 open curves with the highestprogressamong those that traded in the last hour;graduatedthe newest 500 graduations of the last 24 h.- A
nullvalue never matches a range.400for an unknown parameter, a malformed range, an unknown view or a malformed launchpad id; the error names the parameter.