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

Example

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

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.
• 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