Free Market Sentiment API

Endpoints

Examples

curl https://xoomar.com/api/markets/sentiment/btc

import requests

r = requests.get("https://xoomar.com/api/markets/sentiment")
for row in r.json()["data"]["data"]:
    print(f"{row['slug']}: {row['sentimentLabel']} composite {row['compositeScore']}")

const res = await fetch("https://xoomar.com/api/markets/sentiment/btc?history=30d");
const { data } = await res.json();
data.forEach(r => console.log(`${r.ts}: ${r.composite}`));

Honest Limits

• Recomputes hourly. Not a real-time feed.
• News layer scored by our language models from our own coverage; crowd layer from funding rates; institutional from COT positioning.
• Score range is -1 to +1. Values near 0 are neutral.
• Not all layers are available for all assets (e.g., COT layer is null for crypto assets without CME futures).

Main Features

• ✓Multi-layer sentiment for 17 assets across crypto, FX, indices, and commodities, recomputed every hour.
• ✓Three independent layers per asset: AI-scored news coverage, crowd positioning from funding and ratio data, and institutional positioning from COT.
• ✓Composite score with transparent weights (news 0.5, crowd 0.25, institutional 0.25) and null-safe renormalization when a layer has no data.
• ✓Both 24h and 7d windows per asset, plus the Crypto Fear & Greed Index for crypto assets.
• ✓Per-asset history endpoint for charting how sentiment evolved into and out of market events.

How It Works

Each layer has its own clock; the aggregate runs hourly.

Real Example

Request

curl "https://xoomar.com/api/markets/sentiment"

Response (captured live, trimmed)

{
  "data": {
    "totalAssets": 26,
    "window": "24h",
    "cadence": "5-minute sliding window",
    "data": [
      {
        "slug": "btc",
        "name": "Bitcoin",
        "kind": "crypto",
        "window": "24h",
        "timestamp": "2026-09-14T14:25:00.828Z",
        "compositeScore": 0.5065,
        "sentimentLabel": "BULLISH",
        "newsLayer": { "score": 0.21, "articlesCount": 14 },
        "crowdLayer": { "score": 0.0129 },
        "institutionalLayer": { "score": 1.0 },
        "fearGreedIndex": 12,
        "divergenceAlert": { "signal": "NEUTRAL_ALIGNED", "message": "Components broadly agree; no positioning note." },
        "metadata": { "cot": null, "dvol": 37.97, "window": "24h" }
      }
    ]
  },
  "updatedAt": "2026-09-14T14:30:00.000Z",
  "source": "xoomar.com",
  "docs": "https://xoomar.com/markets/api"
}

One record per asset with the latest scores for the requested window (?window=24h or 7d). Scores are numbers from -1 to +1; a layer with no data has score null and is left out of the composite.

What People Build With This

Response Shape

Every endpoint returns the same JSON envelope: { data, updatedAt, source, docs }. The data field is an object with these fields:

Per-asset history at /api/markets/sentiment/{slug}?history=7d|30d|all returns flat rows: ts, window, composite, newsScore, newsCount, crowdScore, institutionalScore, fearGreed, divergenceSignal, divergenceMessage, metadata (scores as decimal strings, oldest first).

Numeric values arrive as strings where precision matters (prices, rates); parse with your language's decimal type for accounting-grade math. Rate limiting is fair-use per IP; a 429 response includes a Retry-After header. No authentication or API key needed. Attribution is appreciated: xoomar.com/markets.

Need more headroom? A free account raises your limit to 120 requests a minute with an X-API-Key header.