Docs
Api referenceMarket data

Price history (candles) from the account's broker

GET
/v1/accounts/{id}/candles

Open, high, low and close bars for one symbol or instrument, read from the account's own MetaTrader terminal: timeframe M1, M5, M15, M30, H1, H4, D1, W1 or MN1, and up to 1,000 bars (count, default 100) counting back from the current one, oldest first; the last bar is still forming. Times are when each bar opened, in UTC (converted with the broker's current clock offset, so bars from before its last daylight-saving change can be an hour out). tickVolume counts price changes, not traded volume. The account must be online (409 ACCOUNT_NOT_READY otherwise). Each call reaches the terminal and is charged to the account's live budget (300 a minute + 50, shared with quotes and fresh figures); past it this answers 429 RATE_LIMITED with retry-after.

Available after the next scheduled maintenance. Until the account's terminal has been updated, this answers 501 CAPABILITY_UNAVAILABLE.

Authorization

apiKey
AuthorizationBearer <token>

Authorization: Bearer fx_live_<id>_<secret>.

A key is shown once, at creation. We cannot show it again or recover it for you. Keys carry a label (live or test) in the key itself, so each configuration is easy to tell apart. Both reach real brokers: test with a broker demo account.

Scopes are per key. A key without accounts:write can read accounts and nothing else.

In: header

Path Parameters

id*string
Formatuuid

Query Parameters

symbol?string

The broker symbol, exactly as this broker names it. Send this or instrument.

instrument?string

An instrument (GET /v1/instruments), read as this account's own symbol for it. Send this or symbol.

timeframe*string

The bar size: minutes (M), hours (H), a day, a week or a month.

Value in

  • "M1"
  • "M5"
  • "M15"
  • "M30"
  • "H1"
  • "H4"
  • "D1"
  • "W1"
  • "MN1"
count?integer

How many bars, counting back from the current one. At most 1,000.

Range1 <= value <= 1000
Default100

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/accounts/497f6eca-6276-4993-bfeb-53cbbbba6f08/candles?symbol=XAUUSD&instrument=XAUUSD&timeframe=M1"
{  "data": {    "symbol": "XAUUSD",    "instrument": null,    "timeframe": "H1",    "digits": 2,    "candles": [      {        "time": "2026-10-23T13:00:00Z",        "open": "2650.10",        "high": "2655.25",        "low": "2648.00",        "close": "2652.50",        "tickVolume": 1234,        "spread": 35      }    ]  }}