get
https://public-api.birdeye.so/defi/v3/price/stats/single
Get the price stats (current price, high/low, percentage change) by time frame for one token
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Price stats for one token across selected timeframes.
- Returns current price, high, low, and price-change percent for each 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 the token supports scaled UI amount extension.
Reading the numbers. price_change_percent compares the current price with the selected timeframe window. high and low are the highest and lowest prices inside that timeframe.
- Standard
- Starter
- Premium
- Business
- Enterprise
All chains ⛓️ ✨
Compute Unit ⚙️
- 8 CU per request.
Use Cases 💡
- Build compact price-stat cards with current price, high, low, and percentage change.
- Power alert thresholds across short and medium timeframes without fetching full candles.
- Rank tokens by price momentum across the exact windows your product cares about.
- Add high/low context to watchlists, token profile headers, and trading widgets.
How to Use 🛠️
- Provide
addressas the token address and setx-chain. - Pass
list_timeframe=1m,1h,24hor another set of up to 3 supported timeframes. - Set
ui_amount_mode=raworscaledconsistently with your Token-2022 price handling. - Use OHLCV endpoints when you need full candle series instead of summary stats.
Best Practices ✅
- Use price stats for lightweight momentum widgets and alerts.
- Keep timeframe sets consistent across tokens when ranking or comparing performance.
- Combine price stats with volume and liquidity data before treating price movement as meaningful.