Price Data API

Use this endpoint to fetch OHLCV candle data for charts and analysis.

Endpoint

GET https://api.darwintiq.com/v1/priceData

Query parameters

symbol (required)
timeframe (optional) — M1 (default), M5, M15, M30, H1, H4, D1
sort (optional) — ASC (default) | DESC
begin (optional) — start time (YYYY-MM-DD HH:MM:SS)
latest (optional) — 1 to return the latest slice
attach_supres (optional) — 1 to include Support/Resistance payload when available
attachSupRes (optional) — camelCase alias for attach_supres

Example

curl -H "Authorization: Bearer [YOUR_TOKEN]" \
  "https://api.darwintiq.com/v1/priceData?symbol=EURUSD&timeframe=M1&sort=ASC&begin=2026-02-10 00:00:00"

Response (example)

{
  "status": "success",
  "symbol": "EURUSD",
  "timeframe": "M1",
  "candles": [
    {
      "opentime": "2026-02-10 18:34:00",
      "open": 1.13406,
      "high": 1.13411,
      "low": 1.13390,
      "close": 1.13404,
      "volume": 162
    }
  ],
  "timeSemantics": {
    "version": 1,
    "fieldBases": {
      "candles[].opentime": "BROKER_NY_CLOSE"
    }
  }
}

Field reference

Field	Type	Description
`status`	string	`success` when the request succeeds.
`symbol`	string	Requested symbol.
`timeframe`	string	Candle timeframe.
`candles`	array	Candle data array.
`candles[].opentime`	string	Candle open time in broker chart time (`BROKER_NY_CLOSE`, Darwinex/MT4 NY-close aligned time).
`candles[].open`	number	Open price.
`candles[].high`	number	High price.
`candles[].low`	number	Low price.
`candles[].close`	number	Close price.
`candles[].volume`	number	Tick volume.
`supres`	object \| null	Optional support/resistance payload (when `attach_supres=1`).
`meta`	object \| null	Optional metadata block from upstream.
`timeSemantics`	object \| null	Optional timestamp semantics metadata for interpreting timestamp fields.
`timeSemantics.version`	number	Metadata version (currently `1`).
`timeSemantics.fieldBases`	object	Map of field paths to time basis identifiers.
`timeSemantics.notes`	array \| null	Optional human-readable notes about timestamp semantics.

Notes

Candle values may be encoded as numbers or numeric strings depending on upstream source.
If latest=1 is used, the payload still returns the same top-level shape, but with the most recent data slice only.
Friendly symbol aliases are normalized before the upstream request, for example DAX -> GDAXI and SPX500 -> SP500.
BROKER_NY_CLOSE means Darwinex/MT4 chart time aligned to New York close (typically UTC+2 in winter / UTC+3 in summer).
If timeSemantics is present, prefer it over hard-coded assumptions in API clients.

Errors

400 missing or invalid symbol
401 missing bearer token
403 invalid token or no subscription access for symbol
429 per-token rate limit exceeded
500 upstream or internal error