get
https://public-api.birdeye.so/defi/v3/token/market-data
Retrieve market data of a specified token.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Focused market fundamentals for one token.
- Returns current price together with liquidity, market cap, FDV, supply, circulating supply, and holder metrics when available.
- Use
ui_amount_mode=scaledfor Solana Token-2022 scaled UI amounts when the token supports scaled UI amount extension. - Use this endpoint when you need current market state and valuation, but do not need timeframe-based trade activity or change windows.
- Standard
- Starter
- Premium
- Business
- Enterprise
All chains ⛓️ ✨
Compute Unit ⚙️
- 10 CU per request.
Use Cases 💡
- Show current token price and market metrics in trading panels, portfolio dashboards, and token profile headers.
- Monitor liquidity, supply, holder, FDV, and market-cap signals for token health.
- Build ranking systems that compare valuation and liquidity quality across tokens.
- Combine with metadata to create lightweight but complete token cards.
How to Use 🛠️
- Provide
addressas the token address and setx-chainfor the target network. - Set
ui_amount_mode=rawfor raw decimal-adjusted amounts, orui_amount_mode=scaledfor Solana Token-2022 scaled UI amounts when supported. - Use this endpoint when current price, liquidity, supply, and valuation are enough for the view.
- Use Token Trade Data when you also need buy/sell activity, trader counts, and volume by timeframe.
Best Practices ✅
- Use this endpoint for high-refresh token cards where Token Overview would return more data than needed.
- Compare liquidity and FDV together to avoid ranking tokens by valuation without market depth context.
- Keep
ui_amount_modeconsistent across market-data, overview, and holder endpoints for Token-2022 scaled UI amount tokens.