GET /v1/summary

Market Summary — Bias Endpoint

A single call that returns an aggregated bullish / bearish / neutral bias, a confidence score, key support/resistance levels, and a plain-English summary explaining the call. Built from 26 indicator series — a subset of the 42 we maintain for the symbol.

Request cURL

bash

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://tickatlas.com/v1/summary?symbol=XAUUSD&timeframe=H1"

Response 200 OK · application/json

json

{
  "success": true,
  "data": {
    "symbol": "XAUUSD",
    "timeframe": "H1",
    "bias": "bearish",
    "bias_strength": "normal",
    "confidence": 0.53,
    "trend_score": -3.0,
    "momentum_score": 0.5,
    "volatility_score": 4.19,
    "signals": {
      "trend": "bearish",
      "momentum": "neutral",
      "volatility": "normal",
      "volume": "bullish"
    },
    "key_levels": {
      "resistance": [
        4022.264
      ],
      "support": [
        3969.285
      ]
    },
    "updated_at": 1787229614
  }
}

Query parameters

symbol: Required. Symbol code (e.g. XAUUSD, EURUSD, BTCUSD).
timeframe: Optional, default H1. One of M1, M5, M15, M30, H1, H4, D1.

Response fields

bias: String — one of bullish, bearish, neutral.
confidence: Float, bounded by the scoring ladder to 0.3–0.9 (e.g. 0.82) — never 0 and never 1. Threshold on it to filter weak readings.
summary: Plain-English explanation, assembled from the measured values by fixed templates — safe to embed directly in LLM prompts or alerts.
key_levels: Support / resistance arrays holding the current Bollinger lower and upper band respectively — exactly one value each, or empty if the bands are unavailable.

Tip: See the Market Sentiment API landing page for a full LLM-integration example, or the Market Summary product page for a product-level walkthrough.