OHLCV - Base/Quote

curl --request GET \
  --url https://public-api.birdeye.so/defi/ohlcv/base_quote \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/defi/ohlcv/base_quote', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "items": [
      {
        "o": 128.2848293438851,
        "c": 127.98180512820512,
        "h": 128.64650816293124,
        "l": 127.91584674904873,
        "vBase": 58641.16636665621,
        "vQuote": 4362436.09417201,
        "unixTime": 1726670700
      },
      {
        "o": 127.98180512820512,
        "c": 128.0549796460581,
        "h": 128.51250171609132,
        "l": 127.89610078074669,
        "vBase": 47861.13031539581,
        "vQuote": 3913815.120231004,
        "unixTime": 1726671600
      }
    ],
    "baseAddress": "So11111111111111111111111111111111111111112",
    "quoteAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "isScaledUiTokenBase": false,
    "isScaledUiTokenQuote": false,
    "type": "15m"
  }
}

GET

defi

ohlcv

base_quote

OHLCV - Base/Quote

curl --request GET \
  --url https://public-api.birdeye.so/defi/ohlcv/base_quote \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/defi/ohlcv/base_quote', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {
    "items": [
      {
        "o": 128.2848293438851,
        "c": 127.98180512820512,
        "h": 128.64650816293124,
        "l": 127.91584674904873,
        "vBase": 58641.16636665621,
        "vQuote": 4362436.09417201,
        "unixTime": 1726670700
      },
      {
        "o": 127.98180512820512,
        "c": 128.0549796460581,
        "h": 128.51250171609132,
        "l": 127.89610078074669,
        "vBase": 47861.13031539581,
        "vQuote": 3913815.120231004,
        "unixTime": 1726671600
      }
    ],
    "baseAddress": "So11111111111111111111111111111111111111112",
    "quoteAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "isScaledUiTokenBase": false,
    "isScaledUiTokenQuote": false,
    "type": "15m"
  }
}

Usage Note
Accessibility
Chain Supported

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 candle type.
This is useful for consolidated market views where the same asset pair trades across multiple pools or venues.
Switch to OHLCV - Pair when venue-specific candles matter more than aggregate market behavior.

Compute Unit ⚙️

This endpoint consumes 35 CU per 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-chain for the target network.
Pass the base and quote addresses using the documented query parameters.
Set time_from, time_to, and the candle type needed 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.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

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

base_address

string

required

The address of the base token.

quote_address

string

required

The address of the quote token.

type

enum<string>

required

OHLCV time frame.

Available options:

1m,

3m,

5m,

15m,

30m,

1H,

2H,

4H,

6H,

8H,

12H,

1D,

3D,

1W,

1M

time_from

integer

required

Specify the start time using unix timestamps in seconds

Required range: 0 <= x <= 10000000000

time_to

integer

required

Specify the end time using unix timestamps in seconds

Required range: 0 <= x <= 10000000000

ui_amount_mode

enum<string>

default:raw

Indicate whether to use the scaled amount for scaled ui amount tokens. Only support solana

Available options:

raw,

scaled,

both

Response

JSON object containing list of ohlc and volume of base and quote

success

boolean

required

Whether the request completed successfully.

data

object

required

OHLCV candle series for a base/quote market.

Show child attributes