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"]:
    if row["window"] == "24h":
        print(f"{row['slug']}: composite {row['composite']}")

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 GPT 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": [
    {
      "slug": "btc",
      "name": "Bitcoin",
      "kind": "crypto",
      "window": "24h",
      "ts": "2026-06-12T15:00:03.798Z",
      "newsScore": null,
      "newsCount": 0,
      "crowdScore": "0.0129",
      "institutionalScore": "1.0000",
      "fearGreed": 12,
      "composite": "0.5065"
    }
  ],
  "updatedAt": "2026-06-12T15:08:35.828Z",
  "source": "xoomar.com",
  "docs": "https://xoomar.com/markets/api"
}

One row per asset per window with the latest scores. Scores are strings to preserve precision; parse before comparing.

What People Build With This

Response Shape

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

Returns the latest score per asset per window. Per-asset history is available at /api/markets/sentiment/{slug}.

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, no API key, no signup. Attribution is appreciated: xoomar.com/markets.