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
    }
  ]
}

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 (UTC).
`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.

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.

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