OHLCV - Birdeye Data

OHLCV

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

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

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

{
  "success": true,
  "data": {
    "isScaledUiToken": false,
    "items": [
      {
        "o": 128.27328370924414,
        "h": 128.6281001340782,
        "l": 127.91200927364626,
        "c": 127.97284640184616,
        "v": 58641.16636665621,
        "vUsd": 7506048,
        "unixTime": 1726670700,
        "address": "So11111111111111111111111111111111111111112",
        "type": "15m",
        "currency": "usd"
      },
      {
        "o": 127.97284640184616,
        "h": 128.49450996585105,
        "l": 127.89354285873108,
        "c": 128.04188346328968,
        "v": 47861.13031539581,
        "vUsd": 6127931,
        "unixTime": 1726671600,
        "address": "So11111111111111111111111111111111111111112",
        "type": "15m",
        "currency": "usd"
      }
    ],
    "direction": "prev",
    "limit": 2,
    "next_cursor": 1768784520,
    "prev_cursor": 1768784460,
    "has_more": true
  }
}

GET

defi

ohlcv

OHLCV

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

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

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

{
  "success": true,
  "data": {
    "isScaledUiToken": false,
    "items": [
      {
        "o": 128.27328370924414,
        "h": 128.6281001340782,
        "l": 127.91200927364626,
        "c": 127.97284640184616,
        "v": 58641.16636665621,
        "vUsd": 7506048,
        "unixTime": 1726670700,
        "address": "So11111111111111111111111111111111111111112",
        "type": "15m",
        "currency": "usd"
      },
      {
        "o": 127.97284640184616,
        "h": 128.49450996585105,
        "l": 127.89354285873108,
        "c": 128.04188346328968,
        "v": 47861.13031539581,
        "vUsd": 6127931,
        "unixTime": 1726671600,
        "address": "So11111111111111111111111111111111111111112",
        "type": "15m",
        "currency": "usd"
      }
    ],
    "direction": "prev",
    "limit": 2,
    "next_cursor": 1768784520,
    "prev_cursor": 1768784460,
    "has_more": true
  }
}

Usage Note
Accessibility
Chain Supported

Legacy token OHLCV candles.

Request one token address plus time_from, time_to, and candle type.
This endpoint returns open, high, low, close, and volume buckets for charting and historical analysis.
Use the legacy OHLCV endpoint when the standard interval set is enough and you do not need V3-only options like second-level intervals or count mode.
Prefer V3 OHLCV when you need 1s, 15s, 30s, count_limit, padding, outlier, or inversion.

Compute Unit ⚙️

This endpoint consumes 35 CU per request.

Use Cases 💡

Render classic candlestick charts for token detail pages and trading dashboards.
Backtest price action with volume-aware buckets over fixed historical windows.
Compare regime shifts before and after launches, liquidity adds, or large wallet activity.
Feed technical-analysis indicators that rely on candle structure rather than spot price alone.

How to Use 🛠️

Set x-chain for the target network.
Pass the token address in address.
Define the candle window with time_from and time_to.
Choose type from the supported legacy intervals such as 1m, 5m, 1H, 1D, 1W, or 1M.

Best Practices ✅

Pick the coarsest interval that still answers the question to keep charts lighter and easier to scan.
Keep chart timezone and bucket labels consistent with your other historical endpoints.
Move to OHLCV V3 when you need finer launch-time analysis or more control over returned buckets.

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

address

string

required

The address of the token contract.

type

enum<string>

required

OHLCV time frame.

Available options:

1m,

3m,

5m,

15m,

30m,

1H,

2H,

4H,

6H,

8H,

12H,

1D,

3D,

1W,

1M

currency

enum<string>

default:usd

Currency in which OHLCV data is presented. Choose between usd or native token.

Available options:

usd,

native

chart_type

enum<string>

default:price

Display OHLC as token price or market cap. mcap mode only applies to token OHLCV on Solana and falls back to price if supply is unavailable. Default: price

Available options:

price,

mcap

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 ohlcv data of a token

success

boolean

required

Whether the request completed successfully.

data

object

required

OHLCV candle series for the requested token.

Show child attributes