API Endpoints

OHLCV V3 - Pair

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

Retrieve candlestick data in OHLCV format of a specified pair. 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 pair OHLCV with finer intervals and count mode.

  • V3 pair candles support 1s, 15s, and 30s intervals in addition to the legacy set.
  • 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 pair-scoped candles when you need one venue's precise market behavior instead of token-level aggregation.
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 💡
  • Inspect launch-time candles for a single pair with second-level precision.
  • Compare venues for the same asset and detect price fragmentation or temporary dislocations.
  • Backtest pool-specific execution logic, routing, or market-making behavior.
  • Build pair-native charts for traders who care about one exact market, not blended token pricing.
How to Use 🛠️
  • Set x-chain to one of the supported V3 networks.
  • Pass the pair address plus type.
  • Use mode=range for bounded chart windows, or mode=count for a rolling candle count.
  • Enable padding only when your chart explicitly requires contiguous empty buckets.
Best Practices ✅
  • Use pair V3 for launch forensics and short-window analysis where venue specificity matters.
  • Keep your venue labeling explicit in UI so users do not confuse pair candles with aggregate token candles.
  • Pair these candles with liquidity data when diagnosing sudden wick behavior or temporary price distortions.

Query Params
string
required

The address of a pair contract

string
enum
required

OHLCV V3 time frame.

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

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:
boolean
enum

Indicate whether to invert the base/quote on pair. Default: false

Allowed:
Headers
string
enum
Defaults to solana

Solana, Base, BSC, Ethereum, Monad, Fogo, Mantle, Hyperevm, Megaeth, Robinhood network.

Responses

Updated about 18 hours 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 about 18 hours ago

Did this page help you?