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…
  • Empty candles are not displayed
    • Data retention for new intervals
      • 1s: Up to 2 weeks
      • 15s and 30s: Up to 3 months
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 network only.

Allowed:
Responses

Updated about 2 months ago

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 2 months ago