SupRes (Support/Resistance) API

Use this endpoint to retrieve Support/Resistance snapshots.

Endpoint

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

Query parameters

• symbol (required)
• begin (optional) — start time (YYYY-MM-DD HH:MM:SS) for range mode
• sort (optional) — ASC (default) | DESC
• latest (optional) — 1 returns only the latest snapshot
• include_candles (optional) — 1 to include candle payload in range mode
• attach (optional) — upstream attach flag for additional context data

Example

curl -H "Authorization: Bearer [YOUR_TOKEN]" \
  "https://api.darwintiq.com/v1/supres?symbol=EURUSD&latest=1"

Response (example)

{
  "status": "success",
  "symbol": "EURUSD",
  "latest": true,
  "opentime": "2026-02-23 14:35:00",
  "snapshot": {
    "cur": [
      {
        "idx": 0,
        "type": "S",
        "price": 1.0829,
        "touches": 3,
        "age_bars": 2,
        "score": 4.6
      },
      {
        "idx": 1,
        "type": "R",
        "price": 1.0864,
        "touches": 2,
        "age_bars": 5,
        "score": 2.9
      }
    ],
    "mtf": [
      {
        "idx": 0,
        "type": "R",
        "price": 1.0882,
        "touches": 1,
        "age_bars": 3,
        "score": 1.8,
        "tf": "H1"
      }
    ],
    "meta": {
      "bar_open": "2026-02-23 14:35:00",
      "source_bar_shift": 1,
      "is_live_bar": false,
      "snapshot_age_sec": 42
    },
    "reg": {
      "mid": { "t1": "2026-02-23 12:00:00", "y1": 1.0831, "t2": "2026-02-23 14:35:00", "y2": 1.0846 },
      "up": { "t1": "2026-02-23 12:00:00", "y1": 1.0862, "t2": "2026-02-23 14:35:00", "y2": 1.0877 },
      "dn": { "t1": "2026-02-23 12:00:00", "y1": 1.0800, "t2": "2026-02-23 14:35:00", "y2": 1.0815 }
    },
    "swing": {
      "top": { "t1": "2026-02-23 13:10:00", "y1": 1.0868, "t2": "2026-02-23 14:35:00", "y2": 1.0872 },
      "bot": { "t1": "2026-02-23 13:10:00", "y1": 1.0819, "t2": "2026-02-23 14:35:00", "y2": 1.0823 }
    }
  },
  "timeSemantics": {
    "version": 1,
    "fieldBases": {
      "opentime": "BROKER_NY_CLOSE"
    }
  }
}

Notes

• type: S = support, R = resistance
• touches: how often price respected the level in the snapshot window
• age_bars (optional): bars since the level's last relevant pivot/cluster event inside that timeframe
• score (optional): upstream ranking score used to prioritize stronger/more recent levels
• snapshot.meta.is_live_bar=false means the snapshot was generated from the last closed bar (more stable); true means the current/open bar
• snapshot.meta.snapshot_age_sec measures snapshot freshness on the API response path (different from age_bars)

Field reference

Field	Type	Description
status	string	success when the request succeeds.
symbol	string	Requested symbol.
latest	boolean	Present in latest mode responses.
opentime	string | null	Snapshot timestamp in broker chart time (BROKER_NY_CLOSE) in latest mode.
snapshot	object | null	Latest mode snapshot object.
snapshot.cur	array	Current-timeframe levels.
snapshot.cur[].idx	number	Index in snapshot.
snapshot.cur[].type	string	S or R.
snapshot.cur[].price	number	Level price.
snapshot.cur[].touches	number	Touch count in window.
snapshot.cur[].age_bars	number	Optional age in bars within the source timeframe.
snapshot.cur[].score	number	Optional upstream quality/ranking score (higher = stronger/more relevant).
snapshot.mtf	array	Multi-timeframe levels (if present).
snapshot.mtf[].idx	number	Index in MTF list.
snapshot.mtf[].type	string	S or R.
snapshot.mtf[].price	number	Level price.
snapshot.mtf[].touches	number	Touch count in window.
snapshot.mtf[].age_bars	number	Optional age in bars within the listed MTF (snapshot.mtf[].tf).
snapshot.mtf[].score	number	Optional upstream quality/ranking score (higher = stronger/more relevant).
snapshot.mtf[].tf	string	Timeframe label (e.g., H1).
snapshot.meta	object | null	Optional snapshot metadata (freshness/source info).
snapshot.meta.bar_open	string	Source bar open time in broker chart time (BROKER_NY_CLOSE).
snapshot.meta.source_bar_shift	number	Source bar offset used upstream (0 = live/open bar, 1 = last closed bar).
snapshot.meta.is_live_bar	boolean	Whether the snapshot was generated from the current/open bar.
snapshot.meta.snapshot_age_sec	number	Approximate age of this snapshot at response generation time, in seconds.
snapshot.reg	object | null	Optional regression channel lines (mid/up/dn).
snapshot.swing	object | null	Optional swing lines (top/bot).
begin	string	Present in range mode responses.
sort	string	Present in range mode responses (ASC/DESC).
count	number	Number of range snapshots.
supres	object	Range mode map keyed by opentime.
supres.<opentime>	object | null	Snapshot at that broker-time timestamp (BROKER_NY_CLOSE).
candles	array	Optional candles in range mode (include_candles=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.

Timestamp semantics

• 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