get
https://public-api.birdeye.so/defi/ohlcv/base_quote
Retrieve candlestick data in OHLCV format of a specified base-quote pair. Maximum 1000 records.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Aggregated OHLCV for a base/quote market.
- Use this endpoint when you want candles across markets that share the same base and quote assets, rather than one explicit pair address.
- Provide the base and quote token addresses plus
time_from,time_to, and candletype. - This is useful for consolidated market views where the same asset pair trades across multiple pools or venues.
- Switch to
OHLCV - Pairwhen venue-specific candles matter more than aggregate market behavior.
- Standard
- Lite
- Starter
- Premium
- Business
- Enterprise
All chains ⛓️ ✨
Compute Unit ⚙️
- This endpoint consumes
35 CUper request.
Use Cases 💡
- Build consolidated base/quote charts across multiple markets.
- Reduce venue noise when the same pair trades across fragmented liquidity.
- Compare aggregate market direction with individual-pair behavior.
- Power dashboards that focus on the trading relationship between two assets, not one pool.
How to Use 🛠️
- Set
x-chainfor the target network. - Pass the base and quote addresses using the documented query parameters.
- Set
time_from,time_to, and the candletypeneeded for your chart. - Use pair-level OHLCV if you later need to drill into one venue behind the aggregate.
Best Practices ✅
- Use this endpoint first for a broad market read, then drill down into individual pairs where anomalies appear.
- Keep your base/quote ordering consistent so chart histories do not flip direction unexpectedly.
- Pair aggregate OHLCV with per-pair liquidity or price spreads when explaining divergences across venues.