GET /networks/{network}/tokens/search filters the tokens on one chain by 24h, 7d and 30d volume, liquidity, FDV, price, 24h price change, swap count and creation time, and sorts what is left. GET /tokens/search does the same across several chains at once. Neither needs a key. Today’s biggest 24h gainers on Ethereum with at least 1M of volume:
Which plan you need
Both endpoints work on every plan. A key changes the limits and the host.
The key goes in
Authorization on its own. A screener that refreshes often is where the per-minute limit bites first; compare plans on pricing and get a key in console.dexpaprika.com.
Filters and sorting
Every filter is optional and they combine with AND.order_by takes volume_usd_24h (the default), volume_usd_7d, volume_usd_30d, liquidity_usd, txns_24h, price_change_percentage_24h, created_at or fdv_usd, and sort takes desc (the default) or asc. limit is 1 to 100, default 10.
Results carry addresses and numbers, not names. Add detailed=true to get name, symbol and decimals too, plus activity over the last 1m, 5m, 15m, 30m, 1h, 6h and 24h.
A gainers screener in Python
This script lists the biggest 24h gainers on Ethereum that clear 1M of volume, then pages once to get the next batch. Two requests:Things to know
Send the same filters with every cursor.next_cursor continues the query that produced it. Send it with the same filters and sort, as the script does; the cursor alone answers 400 with invalid cursor.
Only the 24h price change filters tokens. Pool search also filters on 5m, 1h, 6h and 48h price change; token search does not, and it drops those parameters without an error. See pool filtering for the pool windows.
created_at is not the deployment date. It is when DexPaprika created the token’s record, and a long-established token can carry a recent one. Do not read created_after=-7d as “launched this week”; for brand new pools, use find new pools.
Check outliers before you trust them. Liquidity and FDV are computed from on-chain pool reserves and prices, so one badly priced pool can push a token’s liquidity far out of line. Liquidity many times larger than FDV is one tell. Look at the token’s pools with token pools before acting on it.
Sorting by price change surfaces the extremes. order_by=price_change_percentage_24h puts the most extreme moves first, whatever caused them. Raise liquidity_usd_min and volume_usd_24h_min until the list is what you want to watch.
Where to go next
- Token pools: every pool a token trades in
- Token price and batch prices
- Token search reference and cross-network reference
- Pricing, console.dexpaprika.com and docs home