API Endpoints

OHLCV V3

get
https://public-api.birdeye.so/defi/v3/ohlcv

Retrieve candlestick data in OHLCV format of a specified token. Maximum 5000 records. Compared to v1: Added 1s, 15s, and 30s intervals and no candle padding

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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: 60 CU for up to 1000 candles, 90 CU for up to 2000, and 120 CU for up to 5000.
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.

Query Params
string
required

The address of the token contract.

string
enum
required

OHLCV V3 time frame.

string
enum
Defaults to usd

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

Allowed:
integer
required
0 to 10000000000

Specify the start time using unix timestamps in seconds

integer
required
0 to 10000000000

Specify the end time using unix timestamps in seconds

string
enum
Defaults to raw

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

Allowed:
string
enum

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

Allowed:
integer
0 to 5000

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

boolean
enum

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

Allowed:
boolean
enum

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

Allowed:
Headers
string
enum
Defaults to solana

A chain name listed in supported networks.

Responses

Updated 15 days ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 15 days ago

Did this page help you?