get
https://public-api.birdeye.so/defi/token_overview
Retrieve stats of a specified token.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Full market-intelligence snapshot for one token.
- Returns identity, metadata links, market cap, FDV, supply, holder count, liquidity, price, last trade time, price changes, unique wallets, trade counts, buy/sell counts, and buy/sell volume across multiple frames.
- Use
framesto request specific timeframes. If omitted, the endpoint returns the default timeframe set. ui_amount_mode=scaledapplies Solana Token-2022 scaled UI amount when the token supports scaled UI amount extension.- Frames selection is only supported on solana, base, bsc, ethereum
- User can optionally select one or multiple timeframes using the
framesparameter. - If
framesare not specified, the API will return data for default timeframes: 1m 5m 30m 1h 2h 4h 8h 24h. - If
framesinclude both supported and unsupported intervals, only supported intervals will be returned. - Custom supported timeframes are time intervals separated by comma (,). Users can pass up to 8 intervals. Rules:
- Supported chains: solana, base, bsc, ethereum
- Hours intervals: only support 1h 2h 4h 8h 24h
- Minute intervals: must be from 1m up to 1440m (e.g. 1m,15m,16m,17m,89m,90m,92m,1440m ...).
- Second intervals: must be multiples of 5s, from 5s up to 3600s (e.g. 5s,10s,15s,90s,3600s.
Reading the numbers. Price-change fields compare the current price with the historical price for that frame. uniqueWallet*, trade*, buy*, sell*, and v* fields describe activity inside each timeframe and its change versus the previous matching window.
- Standard
- Starter
- Premium
- Business
- Enterprise
All chains ⛓️ ✨
Compute Unit ⚙️
- 20 CU per request.
Use Cases 💡
- Turn a token address into a complete market-intelligence snapshot with identity, valuation, liquidity, holder, price-action, and trading-activity signals in one response.
- Build rich token profile pages that blend fundamentals (
marketCap,fdv, supply) with real-time market behavior. - Power alpha screens that compare price momentum, wallet growth, buy/sell pressure, trade count, and volume shifts across timeframes.
- Feed bots, alerts, portfolio dashboards, and risk engines before deciding whether to trade, watch, rank, or filter a token.
How to Use 🛠️
- Provide
addressas the token address and setx-chainfor the target network. - Use
frames=1m,5m,1hstyle requests when you only need specific activity windows. - 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 you need the broadest token picture; use focused V3 stats endpoints when you only need metadata, market data, or trade data.
Best Practices ✅
- Use Token Overview as the top-level token profile payload, then drill into specialized endpoints when users open detailed panels.
- Compare price change with volume, unique-wallet, and buy/sell activity together; price alone rarely explains market quality.
- Cache metadata-like fields separately from fast-moving market fields when building high-refresh dashboards.
- Keep timeframe selection consistent across watchlists so ranking and alerts compare tokens fairly.