Skip to content

Get candles data

GetChartData

Description: Retrieves historical candlestick chart data for a specified trading symbol and time range. Supports optional timeframe granularity.

Request Parameters

Name Type Required Description
symbol string Yes Trading symbol (e.g., "EURUSD")
from int Yes Start of the time range (Unix timestamp)
to int Yes End of the time range (Unix timestamp)
frame string No Optional time frame (e.g., "M1", "H1", "D1")

Request Example

{
  "symbol": "EURUSD",
  "from": 1629980000,
  "to": 1630066400,
  "frame": "H1"
}

Response Parameters

Name Type Description
structure array List of fields in each candlestick
data array Array of candlestick data arrays

Each data item contains:
[open, high, low, close, volume, time]

Response Example

{
  "structure": ["open", "high", "low", "close", "volume", "time"],
  "data": [
    [1.1000, 1.1020, 1.0990, 1.1015, 1200, 1629980000],
    [1.1015, 1.1050, 1.1000, 1.1045, 980, 1630066400]
  ]
}