Candles

GET /v1/candles · M1, M5 and M15 OHLC

Draft reference · Examples use sample data.

Request

GET/v1/candlesBearer token

Read-only endpoint. The base URL is a placeholder; these requests are not executable yet.

Request example

curl 'https://API_BASE_URL/v1/candles?feed=justmarkets&interval=M5' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Query parameters

Parameter	Type	Accepted value
`feed`	string · required	justmarkets
`interval`	string · required	M1, M5 or M15

Pagination, date-range filters and batch size are not specified in this API contract.

Example response

200 OK Fixed sample data; not an executable market price.

application/json

{
  "demo": true,
  "feed": "justmarkets",
  "symbol": "XAUUSD",
  "timestamp": "2026-10-06T08:30:00Z",
  "sampled": true,
  "interval": "M5",
  "price_basis": "bid",
  "candles": [
    {
      "timestamp": "2026-10-06T08:15:00Z",
      "open": 2648.1,
      "high": 2651.2,
      "low": 2647.8,
      "close": 2650.4
    }
  ]
}

Response fields

Field	Type	Description
`demo`	boolean	True for sample responses.
`feed`	string	Identifies the broker connection.
`symbol`	string	Client-facing symbol: XAUUSD.
`timestamp`	string	ISO 8601 UTC source timestamp. Fixed in examples.
`sampled`	boolean	True: observations may omit intermediate ticks.
`interval`	string	M1, M5 or M15.
`price_basis`	string	bid: candle values use broker Bid prices.
`candles`	array	OHLC records; may be empty.
`candles[].timestamp`	string	Candle opening time in UTC.
`candles[].open / high / low / close`	number	Broker OHLC prices in USD.

Behavior & errors

An empty candles array is a valid 200 response. It still counts as one request under the proposed usage model.

All endpoints may report invalid credentials (401), a rate limit (429), or an exhausted allowance (429). See error handling →

Try scenarios in the explorer →