Free API
Everything on plainscreener as JSON: pairs, tokens, candles, trades and lists for every pool on Base. No key, no sign-up, and any website may call it (CORS is open).
Limits. 120 requests a minute per IP. Responses are cached at the edge for a few seconds (older candles and trades for a day), and cached answers don't count. Past the limit you get 429 with Retry-After; X-RateLimit-Remaining says how many are left. Need more? The code is open source: run your own.
Conventions. Pairs are pool addresses (v4 pools: their 32-byte id). Times are Unix seconds. Prices in USD use on-chain stablecoin pools; a pair whose quote token has no USD price yet has price_usd: null. trusted is true for pools from known DEX factories (and v4); only those set token prices.
GET /api/v1/search?q=
Pairs for a symbol, name or address, best match first (up to 20).
| q | symbol (degen), name, or a pair or token address |
GET /api/v1/pairs/{pair}
One pair: tokens, price, liquidity, FDV, pooled amounts, and change, volume and buys/sells over 5m, 1h, 6h and 24h. A token address gives its deepest pair.
Try it: https://plainscreener.com/api/v1/pairs/0xcdac0d6c6c59727a65f871236188350531885c43
GET /api/v1/pairs/{pair}/candles
OHLCV candles, oldest first: [time, open, high, low, close, volume_usd].
| res | 1m, 5m, 15m (default), 1h, 4h or 1d |
| unit | usd (default) or native (in the quote token) |
| before | only candles before this time (paging back) |
| limit | 1–1000, default 300 |
Try it: https://plainscreener.com/api/v1/pairs/0xcdac0d6c6c59727a65f871236188350531885c43/candles?res=1h
GET /api/v1/pairs/{pair}/trades
Trades, newest first, including liquidity adds and removals (type: buy, sell, add, remove). Pass next back as before for older ones.
| before | a trade id (block-index) to page from |
| maker | only this wallet's trades |
| limit | 1–500, default 100 |
Try it: https://plainscreener.com/api/v1/pairs/0xcdac0d6c6c59727a65f871236188350531885c43/trades?limit=20
GET /api/v1/tokens/{token}
A token: price, supply, FDV, description and links, safety checks, and its pairs on known DEXes (deepest first, up to 50).
Try it: https://plainscreener.com/api/v1/tokens/0x4200000000000000000000000000000000000006
GET /api/v1/lists/{tab}
The home lists: trending, top, gainers, losers or new (up to 100 pairs), with the same filters as the site.
| w | window for trending, gainers and losers: 5m, 1h, 6h, 24h |
| liq, vol, txns | minimum liquidity, 24h volume (USD) and 24h transactions |
| age | created at most this many hours ago |
| sort, dir | price, c5m, c1h, c6h, c24h, vol, liq, fdv, txns or age; dir=asc for ascending |
Try it: https://plainscreener.com/api/v1/lists/gainers?w=1h&liq=50000
Questions or ideas: open an issue.