Updated every 60 seconds

AI Bias + Narrative API

GET /v1/summary returns a directional bias (bullish/bearish/neutral), a confidence percentage, and a natural-language narrative explaining the call — all powered by the same 42 indicators behind the indicator endpoints.

Get $2.50 Free Credit

No credit card. $2.50 PAYG credit on sign up.

What is the Market Sentiment API?

The /v1/summary endpoint aggregates every pre-calculated indicator we have for a symbol + timeframe into a single AI bias score. Instead of polling RSI, MACD, ADX, Bollinger Bands and 38 more, then writing logic to combine them, you make one HTTP call and receive: bias direction, confidence (0–100), key support/resistance levels, and a plain-English narrative your bot, dashboard, or LLM can render verbatim.

One Request. Instant Data.

cURL

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

Python · feed into an LLM

import requests, openai

summary = requests.get(
    "https://tickatlas.com/v1/summary",
    headers={"X-API-Key": "YOUR_KEY"},
    params={"symbol": "XAUUSD", "timeframe": "H4"},
).json()

prompt = f"""Market context for XAUUSD H4:
Bias: {summary['bias']} (confidence: {summary['confidence']})
{summary['narrative']}
Key levels: support {summary['key_levels']['support']},
            resistance {summary['key_levels']['resistance']}
"""
# Send 'prompt' to your LLM of choice as system context.

Why Use TickAtlas?

One call replaces 42

No fan-out fetches, no aggregation logic. /v1/summary returns the combined signal across every indicator we track for the symbol.

LLM-ready narrative

The `narrative` field is plain English suitable for direct injection into a ChatGPT system prompt, Claude tool response, or a Discord/Slack message.

Bias + confidence, not noise

Each call returns bullish / bearish / neutral plus a 0–100 confidence so your bot can set a directional threshold and skip ambiguous setups.

Plug into any stack

ChatGPT Custom GPTs
Claude Tools
Python / pandas
Node.js
Discord bots
Slack webhooks
n8n
Zapier
Trading dashboards

API Response + Scanner

JSON Response

{
  "success": true,
  "symbol": "XAUUSD",
  "timeframe": "H1",
  "bias": "bullish",
  "confidence": 82,
  "narrative": "Gold breaking above 20-EMA with RSI divergence confirming momentum. MACD histogram expanding.",
  "indicators_analyzed": 42,
  "key_levels": {
    "support": [2318.50, 2305.20],
    "resistance": [2342.00, 2358.75]
  }
}

Python Sentiment Scanner

import requests

PAIRS = ["EURUSD", "GBPUSD", "USDJPY", "XAUUSD", "BTCUSD"]
strong = []
for p in PAIRS:
    s = requests.get(
        "https://tickatlas.com/v1/summary",
        headers={"X-API-Key": "YOUR_API_KEY"},
        params={"symbol": p, "timeframe": "H4"},
    ).json()
    if s["confidence"] >= 75:
        strong.append((p, s["bias"], s["confidence"]))
print(strong)

What the Bias Score Includes

Trend Indicators

EMA alignment, ADX trend strength, Ichimoku cloud position, Parabolic SAR direction

Momentum Indicators

RSI reading, MACD signal line cross, Stochastic position, Momentum(14) zero cross

Volatility Indicators

ATR expansion, Bollinger Band width, Standard Deviation levels

Volume Indicators

OBV trend, MFI level, Accumulation/Distribution line direction

Every new account gets $2.50 in free API credits

Pricing

Pay-As-You-Go

$2.50 free credit

~$0.001/call. Great for testing sentiment-based strategies.

Start Free

Frequently Asked Questions

How is the bias calculated?

We aggregate signals from all 42 indicators we maintain for the symbol and timeframe (trend, momentum, volatility, and volume groups) using a weighted scoring model. The narrative is generated from the same signal set so the explanation stays internally consistent with the numeric bias.

How often does the bias update?

The endpoint refreshes whenever a new candle closes for the requested timeframe — so M1 updates every minute, H1 every hour, D1 once a day. Cached responses live for 60 seconds maximum.

Can I trade off the narrative alone?

The narrative is a description of conditions, not trading advice. Pair the bias + confidence with your own risk management; the API is designed to feed signal pipelines, not auto-execute.

Does it work for crypto and metals?

Yes — any symbol with active indicator coverage on the platform. That includes BTCUSD, ETHUSD, XAUUSD, XAGUSD, all major forex pairs, and indices.

Drop AI bias into your bot in 5 minutes

Every new account gets $2.50 in free PAYG credits. No card required.

Get Free $2.50 Credit Read the Docs