OHLCV V3 - Birdeye Data

OHLCV V3

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

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

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

{
  "success": true,
  "data": {
    "is_scaled_ui_token": false,
    "items": [
      {
        "o": 128.27328370924414,
        "h": 128.6281001340782,
        "l": 127.91200927364626,
        "c": 127.97284640184616,
        "v": 58641.16636665621,
        "v_usd": 7506048,
        "unix_time": 1726670700,
        "address": "So11111111111111111111111111111111111111112",
        "type": "15m",
        "currency": "usd"
      },
      {
        "o": 127.97284640184616,
        "h": 128.49450996585105,
        "l": 127.89354285873108,
        "c": 128.04188346328968,
        "v": 47861.13031539581,
        "v_usd": 7506048,
        "unix_time": 1726671600,
        "address": "So11111111111111111111111111111111111111112",
        "type": "15m",
        "currency": "usd"
      }
    ]
  }
}

GET

defi

ohlcv

OHLCV V3

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

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

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

{
  "success": true,
  "data": {
    "is_scaled_ui_token": false,
    "items": [
      {
        "o": 128.27328370924414,
        "h": 128.6281001340782,
        "l": 127.91200927364626,
        "c": 127.97284640184616,
        "v": 58641.16636665621,
        "v_usd": 7506048,
        "unix_time": 1726670700,
        "address": "So11111111111111111111111111111111111111112",
        "type": "15m",
        "currency": "usd"
      },
      {
        "o": 127.97284640184616,
        "h": 128.49450996585105,
        "l": 127.89354285873108,
        "c": 128.04188346328968,
        "v": 47861.13031539581,
        "v_usd": 7506048,
        "unix_time": 1726671600,
        "address": "So11111111111111111111111111111111111111112",
        "type": "15m",
        "currency": "usd"
      }
    ]
  }
}

Usage Note
Accessibility
Chain Supported

Extended OHLCV with finer intervals and count mode.

V3 adds 1s, 15s, and 30s intervals, plus mode, count_limit, padding, outlier, and inversion.
Empty candles are not returned unless padding=true.
When mode=count, provide either time_from or time_to, but not both; count_limit can go up to 5000.
Data retention for the newest intervals is shorter: 1s up to 2 weeks, 15s and 30s up to 3 months.
Use outlier=false when you want raw candles without Birdeye outlier filtering.

Compute Unit ⚙️

CU is dynamic: 45 CU for up to 1000 items, 75 CU for up to 2000 items, and 100 CU for up to 5000 items.

Use Cases 💡

Analyze launches, breakouts, and microstructure with second-level candles.
Backfill large candle windows for research, charting, and signal generation.
Build advanced chart tools that need control over padding, inversion, and outlier handling.
Study price behavior around wallet activity, liquidity shocks, and execution events.

How to Use 🛠️

Set x-chain to one of the supported V3 networks.
Pass the token address plus type.
Use mode=range with time_from and time_to for normal chart windows.
Use mode=count with either time_from or time_to when you want the latest or previous N candles.

Best Practices ✅

Start with broader intervals, then zoom into 1s or 15s only where the event warrants it.
Leave padding=false for launch and sparse-trading tokens so empty buckets do not imply false activity.
Keep count_limit as small as the use case allows to reduce payload size and CU.

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 V3 time frame.

Available options:

1s,

15s,

30s,

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

mode

enum<string>

Select either range (time range) or count (number of candles). If mode is count, time_from and time_to params must exist but not both. Default: range

Available options:

range,

count

count_limit

integer

Specify the maximum candles returned. Only used with mode "count". Default: 5000

Required range: 0 <= x <= 5000

padding

enum<boolean>

Indicate whether to use padding on empty candles. Default: false

Available options:

true,

false

outlier

enum<boolean>

Indicate whether to allow outliers exist in the results. Default: true

Available options:

true,

false

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 using the V3 schema.

Show child attributes