get
https://public-api.birdeye.so/defi/history_price
Retrieve historical price line chart of a specified token.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Historical price series for one token or pair.
- Set
address_typetotokenorpairdepending on what the address represents. - Use
time_from,time_to, andtypetogether to request a bounded series at the granularity you need. - Returned prices are best suited for line charts, checkpoint analysis, and broad time-series workflows rather than candle-level OHLC studies.
- Choose OHLCV endpoints instead when you need open/high/low/close/volume per bucket.
- Standard
- Lite
- Starter
- Premium
- Business
- Enterprise
All chains ⛓️ ✨
Compute Unit ⚙️
- This endpoint consumes
35 CUper request.
Use Cases 💡
- Retrieves historical USD price series for a token or pair across a selected time window.
- Great for charting, research, and reconstructing token or pair price behavior across a past period.
- Can be used to track performance before and after events such as listings, unlocks, liquidity changes, or major announcements.
- Helpful for portfolio reconstruction, ROI calculators, trade-performance tools, and benchmark studies.
- Add historical context to trade, holder, and smart-money analysis.
How to Use 🛠️
- Set
x-chainfor the target network.- Pass the target
addressand chooseaddress_type=tokenoraddress_type=pair. - Define the time window with
time_fromandtime_to. - Choose
typebased on the granularity needed for your chart or analysis window.
- Pass the target
Best Practices ✅
- Use wider intervals for long backfills and finer intervals only when the question really needs them.
- Align chart labels and downstream joins to the same bucket size you requested here.
- When you need an exact checkpoint instead of a series, switch to
Price - Historical by unix time.