post
https://public-api.birdeye.so/defi/v3/price/stats/multiple
Get the price stats (current price, high/low, percentage change) by time frame for multiple tokens. Max to 20 tokens
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Batch price stats for multiple tokens across selected timeframes.
- Request body accepts token addresses through
list_address. - Maximum batch size is 20 unique token addresses per request.
- Returns current price, high, low, and price-change percent for each token and requested timeframe.
list_timeframeaccepts comma-separated values such as1m,5m,30m,1h,2h,4h,8h,24h,2d,3d, and7d.- Request up to 3 timeframes per call.
ui_amount_mode=scaledapplies Solana Token-2022 scaled UI amount when tokens support scaled UI amount extension.
- Business
- Enterprise
All chains ⛓️ ✨
Compute Unit ⚙️
- Batch CU is calculated as
ceil(8 * token_count^0.8).
Use Cases 💡
- Refresh price-stat tables for many tokens in one request.
- Power screeners that rank multiple tokens by price change, high/low range, and current price.
- Evaluate watchlists for momentum alerts across shared timeframes.
- Build compact market boards without fetching full OHLCV series for every token.
How to Use 🛠️
- Set
x-chainfor the target network. - Send token addresses in the request body and pass
list_timeframein the query. - Keep the timeframe list consistent across all tokens in the batch.
- Set
ui_amount_mode=raworscaledconsistently with your Token-2022 price handling.
Best Practices ✅
- Use this endpoint for batch dashboards and alert scans where high/low and percentage change are enough.
- Combine batch price stats with batch market data when ranking both momentum and market quality.
- Deduplicate token addresses before requesting batch stats.