Pools API
Pool trade stats by trailing window
Buyer and seller wallet counts split apart, plus transactions, volume and liquidity, for ONE pool over eight trailing windows from 5m to 30d.
GET
/api/external/pool-analysis/pool-stats/{chain}/{pool}What it returns
Volume, liquidity, transaction counts and unique buyer/seller wallet counts for one liquidity pool, bucketed over eight trailing windows ending now: 5m, 15m, 1h, 4h, 12h, 1d, 7d, 30d. The pool-keyed sibling of stats-windows — same kind of question, one call, this source's own duration set rather than a different source's. uniqueBuyers, uniqueSellers and uniqueWallets read null on a known source placeholder that has been observed on the longest window(s) for a given pool — never a real zero when it fires; every other field on that same window is a real reading. liquidityUsd describes this one pool at this window and may not match pool-detail's own liquidityUsd for the same pool. On SOL only 5m, 1h, 4h, 1d are published — 15m, 12h, 7d, 30d are null in every field, never 0 — and uniqueWallets is null on every window (distinct wallets across both sides are not counted there; it is never uniqueBuyers + uniqueSellers). An address with no pool answers 200 with every field null.
Chains
- Solana SOL
- BNB Chain BNB
- Ethereum ETH
- Stable STABLE
- Base BASE
- Robinhood Chain RHC
Request
Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.
curl -H "x-dex-data-key: $DEXDATA_API_KEY" \ "https://api.dexdata.io/api/external/pool-analysis/pool-stats/SOL/<pool>"
| Parameter | Description |
|---|---|
chainpath · string · required | The chain the pool lives on. SOL, ETH, BNB, BASE, STABLE and RHC are served; ARC returns 400. CELO, ARB, OP and SCROLL return 400 here. |
poolpath · string · required | The pool identifier — a pool/pair address on most venues, or a 32-byte pool ID where the venue uses one (Uniswap v4). It identifies the POOL, not a token traded in it. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
5m | object | |
5m.volumeUsd | number | null | USD traded in this pool during the window. |
5m.liquidityUsd | number | null | This pool's USD liquidity reading for the window. May not match pool-detail's own liquidityUsd for the same pool — the two come from different upstream questions. |
5m.buys | integer | null | Buy-side transaction count in this window. |
5m.sells | integer | null | Sell-side transaction count in this window. |
5m.uniqueBuyers | integer | null | Distinct wallets that bought in this window. null on a known source placeholder (observed on the longest windows) — never a real zero when it fires. |
5m.uniqueSellers | integer | null | Distinct wallets that sold in this window. Same placeholder caveat as uniqueBuyers. |
5m.uniqueWallets | integer | null | Distinct wallets that did EITHER — not the sum of uniqueBuyers and uniqueSellers (a wallet doing both counts once here). Same placeholder caveat. |
15m | object | |
15m.volumeUsd | number | null | USD traded in this pool during the window. |
15m.liquidityUsd | number | null | This pool's USD liquidity reading for the window. May not match pool-detail's own liquidityUsd for the same pool — the two come from different upstream questions. |
15m.buys | integer | null | Buy-side transaction count in this window. |
15m.sells | integer | null | Sell-side transaction count in this window. |
15m.uniqueBuyers | integer | null | Distinct wallets that bought in this window. null on a known source placeholder (observed on the longest windows) — never a real zero when it fires. |
15m.uniqueSellers | integer | null | Distinct wallets that sold in this window. Same placeholder caveat as uniqueBuyers. |
15m.uniqueWallets | integer | null | Distinct wallets that did EITHER — not the sum of uniqueBuyers and uniqueSellers (a wallet doing both counts once here). Same placeholder caveat. |
1h | object | |
1h.volumeUsd | number | null | USD traded in this pool during the window. |
1h.liquidityUsd | number | null | This pool's USD liquidity reading for the window. May not match pool-detail's own liquidityUsd for the same pool — the two come from different upstream questions. |
1h.buys | integer | null | Buy-side transaction count in this window. |
1h.sells | integer | null | Sell-side transaction count in this window. |
1h.uniqueBuyers | integer | null | Distinct wallets that bought in this window. null on a known source placeholder (observed on the longest windows) — never a real zero when it fires. |
1h.uniqueSellers | integer | null | Distinct wallets that sold in this window. Same placeholder caveat as uniqueBuyers. |
1h.uniqueWallets | integer | null | Distinct wallets that did EITHER — not the sum of uniqueBuyers and uniqueSellers (a wallet doing both counts once here). Same placeholder caveat. |
4h | object | |
4h.volumeUsd | number | null | USD traded in this pool during the window. |
4h.liquidityUsd | number | null | This pool's USD liquidity reading for the window. May not match pool-detail's own liquidityUsd for the same pool — the two come from different upstream questions. |
4h.buys | integer | null | Buy-side transaction count in this window. |
4h.sells | integer | null | Sell-side transaction count in this window. |
4h.uniqueBuyers | integer | null | Distinct wallets that bought in this window. null on a known source placeholder (observed on the longest windows) — never a real zero when it fires. |
4h.uniqueSellers | integer | null | Distinct wallets that sold in this window. Same placeholder caveat as uniqueBuyers. |
4h.uniqueWallets | integer | null | Distinct wallets that did EITHER — not the sum of uniqueBuyers and uniqueSellers (a wallet doing both counts once here). Same placeholder caveat. |
12h | object | |
12h.volumeUsd | number | null | USD traded in this pool during the window. |
12h.liquidityUsd | number | null | This pool's USD liquidity reading for the window. May not match pool-detail's own liquidityUsd for the same pool — the two come from different upstream questions. |
12h.buys | integer | null | Buy-side transaction count in this window. |
12h.sells | integer | null | Sell-side transaction count in this window. |
12h.uniqueBuyers | integer | null | Distinct wallets that bought in this window. null on a known source placeholder (observed on the longest windows) — never a real zero when it fires. |
12h.uniqueSellers | integer | null | Distinct wallets that sold in this window. Same placeholder caveat as uniqueBuyers. |
12h.uniqueWallets | integer | null | Distinct wallets that did EITHER — not the sum of uniqueBuyers and uniqueSellers (a wallet doing both counts once here). Same placeholder caveat. |
1d | object | |
1d.volumeUsd | number | null | USD traded in this pool during the window. |
1d.liquidityUsd | number | null | This pool's USD liquidity reading for the window. May not match pool-detail's own liquidityUsd for the same pool — the two come from different upstream questions. |
1d.buys | integer | null | Buy-side transaction count in this window. |
1d.sells | integer | null | Sell-side transaction count in this window. |
1d.uniqueBuyers | integer | null | Distinct wallets that bought in this window. null on a known source placeholder (observed on the longest windows) — never a real zero when it fires. |
1d.uniqueSellers | integer | null | Distinct wallets that sold in this window. Same placeholder caveat as uniqueBuyers. |
1d.uniqueWallets | integer | null | Distinct wallets that did EITHER — not the sum of uniqueBuyers and uniqueSellers (a wallet doing both counts once here). Same placeholder caveat. |
7d | object | |
7d.volumeUsd | number | null | USD traded in this pool during the window. |
7d.liquidityUsd | number | null | This pool's USD liquidity reading for the window. May not match pool-detail's own liquidityUsd for the same pool — the two come from different upstream questions. |
7d.buys | integer | null | Buy-side transaction count in this window. |
7d.sells | integer | null | Sell-side transaction count in this window. |
7d.uniqueBuyers | integer | null | Distinct wallets that bought in this window. null on a known source placeholder (observed on the longest windows) — never a real zero when it fires. |
7d.uniqueSellers | integer | null | Distinct wallets that sold in this window. Same placeholder caveat as uniqueBuyers. |
7d.uniqueWallets | integer | null | Distinct wallets that did EITHER — not the sum of uniqueBuyers and uniqueSellers (a wallet doing both counts once here). Same placeholder caveat. |
30d | object | |
30d.volumeUsd | number | null | USD traded in this pool during the window. |
30d.liquidityUsd | number | null | This pool's USD liquidity reading for the window. May not match pool-detail's own liquidityUsd for the same pool — the two come from different upstream questions. |
30d.buys | integer | null | Buy-side transaction count in this window. |
30d.sells | integer | null | Sell-side transaction count in this window. |
30d.uniqueBuyers | integer | null | Distinct wallets that bought in this window. null on a known source placeholder (observed on the longest windows) — never a real zero when it fires. |
30d.uniqueSellers | integer | null | Distinct wallets that sold in this window. Same placeholder caveat as uniqueBuyers. |
30d.uniqueWallets | integer | null | Distinct wallets that did EITHER — not the sum of uniqueBuyers and uniqueSellers (a wallet doing both counts once here). Same placeholder caveat. |
Start building with DexData today
Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.
Get a free API key