get
https://public-api.birdeye.so/defi/v3/token/market-data/multiple
Retrieve market data of multiple tokens. Maximum 20 addresses.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Batch market fundamentals for multiple tokens.
- Pass token addresses as a comma-separated list in
list_address. - Maximum batch size is 20 token addresses per request.
- Returns current price, liquidity, valuation, supply, and holder metrics for each indexed token in the request.
- Use
ui_amount_mode=scaledfor Solana Token-2022 scaled UI amounts when tokens support scaled UI amount extension.
- Business
- Enterprise
All chains ⛓️ ✨
Compute Unit ⚙️
- Batch CU is calculated as
ceil(10 * token_count^0.8).
Use Cases 💡
- Build watchlists or token screeners with current price and market data for many tokens.
- Refresh portfolio token metrics in fewer API calls.
- Compare liquidity, valuation, supply, and holder signals across a selected token set.
- Power scheduled alert systems that evaluate many tokens together.
How to Use 🛠️
- Set
x-chainfor the target network. - Pass
list_addressas comma-separated token addresses. - Set
ui_amount_mode=raworscaledconsistently with your Token-2022 amount handling. - Use this endpoint when every row needs current price plus market fundamentals, but not per-timeframe trade windows.
- Use the single endpoint when a user opens one token detail page.
Best Practices ✅
- Use this endpoint for batch dashboards and screeners instead of looping over single-token calls.
- Deduplicate addresses before requesting market data.
- Combine with metadata multiple to render clean token tables with both identity and market context.