Part of Finance Hub API

Sentiment API for aggregate market intelligence

This product packages the strongest derived layer in the SentiSignal stack: daily sentiment buckets, rolling windows, top-asset rankings, and divergence signals across tracked crypto, FX, and commodity symbols.

Get Notified Back to Finance Hub

Aggregate only · shared API key · informational, not advisory

What you get

Aggregate-only by design

The product sells derived intelligence, not raw article rows. You get daily sentiment buckets, rolling windows, and top-asset rankings.

Shared auth and quotas

The same public API key works across Finance Hub market-data products and sentiment endpoints under one plan model.

Tiered intelligence access

Free plans can sample latest daily aggregates, while paid tiers unlock history, rolling windows, and richer rankings.

Cross-asset coverage

Use one contract across crypto, FX, and commodities instead of stitching together multiple ad hoc sentiment datasets.

Endpoints

GET /api/v1/sentiment/daily?asset_type=crypto&symbol=BTC&start_date=2026-04-04&end_date=2026-04-04

Daily sentiment buckets for a single symbol.

GET /api/v1/sentiment/rolling?asset_type=commodity&symbol=GOLD&window=30d

Rolling sentiment averages for a tracked asset.

GET /api/v1/sentiment/assets/top?asset_type=all&metric=attention&window=7d

Top assets ranked by attention, bullishness, bearishness, or divergence. asset_type: crypto | commodity | fx | all. window: 7d | 30d. limit: 1–100 (default 20).

GET /api/v1/sentiment/divergence?asset_type=fx&symbol=EURUSD&window=30d

Enterprise-only price versus sentiment divergence signal. window: 7d | 30d.

New

Attention — how much the market is talking

For any tracked asset: articles in the last hour, 24 hours and 7 days. The 1 h and 24 h counts are compared with the asset’s own usual level, and a plain level tells you whether the topic is quiet, normal, busy, a spike — or has no baseline yet.

1h / 24h / 7d mentions

Counts articles by publication hour, not by when our analysis happened to finish. The current hour is marked partial.

Versus its own normal

For the 1 h ratio the baseline is the same clock hour over the previous seven days; for 24 h it is the daily average. A 3× reading means three times the usual attention, not three times another asset.

Direction, not just volume

The 24 h payload also carries the weighted sentiment mean, bullish/bearish/neutral ratios and what share of mentions have a score (coverage, 0–1).

GET /api/v1/sentiment/attention?key=BTC

The same payload is available from News Search at /api/v1/news/popularity; pick the product scope that matches your key.

Asset	24h	vs usual	Level
BTC	65 articles	0.37×	Quiet
ETH	120 articles	1.79×	Busy
GOLD	48 articles	0.92×	Normal

Illustrative values, not live data. Counts are by publication hour and may lag by a few minutes. Informational only, not investment advice.

Try it in the playground

Quick Start

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.sentisignal.com/api/v1/sentiment/daily?asset_type=crypto&symbol=BTC&start_date=2026-04-04&end_date=2026-04-04"

{
  "status": "success",
  "timestamp": "2026-04-04T12:00:00.000Z",
  "data": {
    "asset_type": "crypto",
    "symbol": "BTC",
    "granularity": "daily",
    "points": [
      {
        "bucket_date": "2026-04-04",
        "article_count": 18,
        "avg_llm_sentiment": 0.34,
        "bullish_ratio": 0.56,
        "bearish_ratio": 0.17,
        "attention_score": 9.12,
        "weighted_sentiment": 0.41
      }
    ]
  },
  "meta": { "credits_used": 1, "plan": "free" }
}

Want the suite-level view? Start at Finance Hub API.

FAQ

Does this expose article-level sentiment rows? +

No. The API returns precomputed aggregates only. That protects the proprietary article-level dataset and is the intended product boundary.

What does the free tier include? +

Free access is limited to the latest daily bucket. Historical daily ranges, rolling windows, and top-assets endpoints require paid access.

Which assets are covered? +

Tracked crypto, FX, and commodity symbols that already flow through the unified analysis pipeline.

Is this trading advice? +

No. Responses are informational indicators built from public-source news analysis and should not be treated as investment advice or execution-grade signals.

Coming Soon

Get notified when the Sentiment Aggregates API launches

We're finalising pricing and terms. Register your email and we'll let you know the moment access opens.

No spam. One email when the Sentiment Aggregates API opens.

Explore the full API suite

One API key covers all products. Finance Hub ->

Suite

Finance Hub

Full API suite

Umbrella landing for the full API suite with one key, one plan, and a shared product story.

View ->

Gold

Gold Price API

Spot, history, conversions

Gold spot prices, historical series back to 2004, and conversions across five weight units.

View ->

Metals

Metals Price API

Gold, silver, platinum, palladium

Daily precious metals coverage with FX conversion and weight-unit support.

View ->

Currencies API

Spot and historical rates

Daily ECB reference rates and historical currency pairs for reporting, analytics, and conversion.

View ->

Cmdty

Commodities Price API

Energy and agriculture

Energy and agriculture endpoints with historical summaries, source transparency, and FX conversion.

View ->

News

News Search API

AI-scored financial news

Keyword and semantic search over AI-analyzed financial news, with importance, quality, and sentiment scores.

View ->

Context

Context API

AI-synthesized answer + sources

One synthesized answer with attributed sources for a natural-language financial question, built from the same news corpus as News Search.

View ->

MCP

MCP Server Finance Hub

Agent-native tool access

Finance tools for Claude, Cursor, and other MCP clients using the same API access model.

View ->