Skip to main content

candleSnapshot Info Endpoint Method

Provides historical candlestick data for a trading pair, including OHLCV values, volume, and trade count.

Updated on
Jun 15, 2026

Parameters

type
string
REQUIRED

The method type to call

req
object
REQUIRED

Request parameters for candle snapshot

coin
string
REQUIRED

Trading pair symbol to retrieve candlestick data for, using standard symbols (e.g., 'BTC', 'ETH', 'SOL') for perpetuals or @index notation for spot markets. For HIP-3 assets, prefix the coin with the dex name, e.g. 'xyz:XYZ100'

interval
string
REQUIRED

Candlestick time interval specifying the duration of each candle. Supported intervals: '1m', '3m', '5m', '15m', '30m', '1h', '2h', '4h', '8h', '12h', '1d', '3d', '1w', '1M'

startTime
integer
REQUIRED

Query start time as Unix timestamp in milliseconds (inclusive). Candles at or after this time will be returned. Use Date.now() in JavaScript or time.time()*1000 in Python to generate timestamps

endTime
integer
REQUIRED

Query end time as Unix timestamp in milliseconds (inclusive). Candles at or before this time will be returned. Defines the upper bound of the historical data range

Returns

array
array

Array of candlestick data

t
integer

Candle open timestamp in milliseconds (Unix epoch time). Marks the beginning of this candlestick period. Use for x-axis plotting in charts and time-series analysis

T
integer

Candle close timestamp in milliseconds (Unix epoch time). Marks the end of this candlestick period. The time range [t, T] defines the complete candle duration

s
string

Trading pair symbol for this candle, matching the requested coin parameter (e.g., 'BTC', 'ETH'). Useful when processing multiple symbols simultaneously

i
string

Candlestick interval matching the requested interval parameter (e.g., '1m', '5m', '1h', '1d'). Confirms the time granularity of this candle data

o
string

Opening price - the first trade price when the candle period began. Returned as string to preserve full decimal precision for accurate charting and analysis

c
string

Closing price - the last trade price when the candle period ended. Critical for price trend analysis and technical indicators. String format maintains decimal precision

h
string

Highest price reached during this candle period. Represents the peak price within the time interval. Returned as string for precise decimal values

l
string

Lowest price reached during this candle period. Represents the minimum price within the time interval. String format preserves decimal precision

v
string

Total trading volume during this candle period, measured in the base asset quantity. Indicates market activity and liquidity. Returned as string to maintain precision for large volume numbers

n
integer

Total number of individual trades that occurred during this candle period. Higher trade counts indicate more active market participation and can signal increased interest or volatility

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free