Still replaying Base history, now at 17 Aug 2024. Prices and lists here are from that day until the indexer reaches the present.

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).

qsymbol (degen), name, or a pair or token address

Try it: https://plainscreener.com/api/v1/search?q=degen

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].

res1m, 5m, 15m (default), 1h, 4h or 1d
unitusd (default) or native (in the quote token)
beforeonly candles before this time (paging back)
limit1–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.

beforea trade id (block-index) to page from
makeronly this wallet's trades
limit1–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.

wwindow for trending, gainers and losers: 5m, 1h, 6h, 24h
liq, vol, txnsminimum liquidity, 24h volume (USD) and 24h transactions
agecreated at most this many hours ago
sort, dirprice, 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.