Skip to main content
GET
OHLCV V3 - Pair

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.
  • 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.
  • 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.
  • 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.
  • 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.

Authorizations

X-API-KEY
string
header
required

API key for authentication

Headers

x-chain
enum<string>
default:solana

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

Available options:
solana,
bsc,
base,
ethereum,
monad,
aptos,
fogo,
mantle,
hyperevm,
megaeth,
robinhood

Query Parameters

address
string
required

The address of a pair 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
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
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
inversion
enum<boolean>

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

Available options:
true,
false

Response

JSON object containing list of ohlcv data of a pair

success
boolean
required

Whether the request completed successfully.

data
object
required

OHLCV candle series for the requested trading pair using the V3 schema.