OHLCV - Pair
curl --request GET \
--url https://public-api.birdeye.so/defi/ohlcv/pair \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/defi/ohlcv/pair"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://public-api.birdeye.so/defi/ohlcv/pair', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"items": [
{
"address": "Czfq3xZZDmsdGdUyrNLtRhGc47cXcZtLG4crryfu44zE",
"c": 131.98629958196778,
"h": 132.23482213379438,
"l": 131.51590533656915,
"o": 131.51590533656915,
"type": "15m",
"unixTime": 1726700400,
"v": 6156.155046497001
},
{
"address": "Czfq3xZZDmsdGdUyrNLtRhGc47cXcZtLG4crryfu44zE",
"c": 132.7284,
"h": 132.81605139774013,
"l": 131.95800580371125,
"o": 131.98629958196778,
"type": "15m",
"unixTime": 1726701300,
"v": 7401.823317684
}
]
}
}{
"success": false,
"message": "Bad request"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Access Denied"
}{
"success": false,
"message": "Too many requests"
}{
"success": false,
"message": "Internal Server Error"
}Price & OHLCV
OHLCV - Pair
deprecated
Retrieve candlestick data in OHLCV format of a specified pair. Maximum 1000 records.
GET
/
defi
/
ohlcv
/
pair
OHLCV - Pair
curl --request GET \
--url https://public-api.birdeye.so/defi/ohlcv/pair \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/defi/ohlcv/pair"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://public-api.birdeye.so/defi/ohlcv/pair', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": {
"items": [
{
"address": "Czfq3xZZDmsdGdUyrNLtRhGc47cXcZtLG4crryfu44zE",
"c": 131.98629958196778,
"h": 132.23482213379438,
"l": 131.51590533656915,
"o": 131.51590533656915,
"type": "15m",
"unixTime": 1726700400,
"v": 6156.155046497001
},
{
"address": "Czfq3xZZDmsdGdUyrNLtRhGc47cXcZtLG4crryfu44zE",
"c": 132.7284,
"h": 132.81605139774013,
"l": 131.95800580371125,
"o": 131.98629958196778,
"type": "15m",
"unixTime": 1726701300,
"v": 7401.823317684
}
]
}
}{
"success": false,
"message": "Bad request"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Access Denied"
}{
"success": false,
"message": "Too many requests"
}{
"success": false,
"message": "Internal Server Error"
}- Usage Note
- Accessibility
- Chain Supported
Legacy OHLCV candles scoped to one pair.
- Pass a pair address when you want market-specific candles from one liquidity venue rather than token-level aggregation.
- Use
time_from,time_to, andtypeto define the candle window and resolution. - Pair candles are useful when DEX-specific pricing matters, especially for fragmented liquidity or venue analysis.
- Choose the V3 pair endpoint when you need second-level intervals or count-based retrieval.
- Standard
- Lite
- Starter
- Premium
- Business
- Enterprise
All chains ⛓️ ✨
Compute Unit ⚙️
Compute Unit ⚙️
- This endpoint consumes
35 CUper request.
Use Cases 💡
Use Cases 💡
- Chart a specific pool or pair instead of blended token pricing.
- Compare price action across different pools for the same asset.
- Monitor venue-specific dislocations, slippage risk, or routing quality.
- Build analytics for LPs, market makers, and DEX-specific trading workflows.
How to Use 🛠️
How to Use 🛠️
- Set
x-chainfor the target network. - Pass the pair address in
address. - Define the time window with
time_fromandtime_to. - Choose a legacy candle interval in
type.
Best Practices ✅
Best Practices ✅
- Use pair candles when the token trades across many venues and you need one market’s exact behavior.
- Keep pair identity stable in your app so users know which venue they are looking at.
- Join pair OHLCV with pair-overview or liquidity data when execution conditions matter as much as price.
Authorizations
API key for authentication
Headers
A chain name listed in supported networks.
Available options:
solana, ethereum, bsc, base, robinhood, sui, mantle, hyperevm, arbitrum, avalanche, optimism, polygon, zksync, monad, aptos, fogo, megaeth Query Parameters
The address of a pair contract
OHLCV time frame.
Available options:
1m, 3m, 5m, 15m, 30m, 1H, 2H, 4H, 6H, 8H, 12H, 1D, 3D, 1W, 1M Specify the start time using unix timestamps in seconds
Required range:
0 <= x <= 10000000000Specify the end time using unix timestamps in seconds
Required range:
0 <= x <= 10000000000Was this page helpful?

