get
https://public-api.birdeye.so/defi/historical_price_unix
Retrieve historical price by unix timestamp.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Exact historical price checkpoint.
- Pass one token address plus a required
unixtimein seconds. - Use this endpoint when you need the price at one exact moment, not a full time series.
- This is useful for PnL checkpoints, valuation snapshots, and event-based lookups where a single timestamp matters more than a chart.
- Standard
- Lite
- Starter
- Premium
- Business
- Enterprise
Solana
Compute Unit ⚙️
- This endpoint consumes
6 CUper request.
Use Cases 💡
- Returns historical USD prices for a token at a certain timestamp.
- Perfect for portfolio time series reconstruction or backtesting strategies.
- Great for generating custom charts, price annotations, and historical comparisons.
- Value a wallet or portfolio at a specific historical checkpoint.
- Measure slippage, entry quality, or event impact at a known timestamp.
- Backfill price annotations for trades, transfers, or on-chain alerts.
- Support ROI and tax-style workflows that require point-in-time pricing.
How to Use 🛠️
- Set
x-chain=solana. - Pass the token mint in
address. - Provide
unixtimein seconds for the checkpoint you want to price. - Use
Price - Historicalinstead when you need a continuous series around the same event.
Best Practices ✅
- Normalize all event timestamps to seconds before calling this endpoint.
- Reuse the same checkpoint price across related calculations so PnL and valuation stay consistent.
- Batch many checkpoints asynchronously in your backend rather than blocking a user flow one request at a time.
Limitations ⚠️
- Solana only.