Market Sentiment

The mood on a whole market — US, gold, silver, BTC and more — from curated smart-money traders.

GET/api/market-sentiment

SentimentIncluded in every plan · one key.

Overview

The macro sibling of Stock Sentiment. It targets about 40 quality-filtered X posts per market for the US market, gold, silver, BTC, Ethereum, oil, DXY, copper and bonds/rates. Curated specialists come first; topic search fills gaps but is capped and downweighted. It uses a strict 72-hour window, reports source mix and source health, keeps X sentiment separate from price action, and returns `aiSummary`: one balanced DeepSeek recap of the evidence. DeepSeek classifies every post specifically toward the requested market, so a comparison such as strong gold / weak dollar is not assigned one generic direction. Search-only evidence and lexicon fallback are hard-capped at low confidence. A failed or undersized refresh preserves last-good data and is exposed with `cached`/`stale` instead of manufacturing a fresh neutral reading. `tweets` contains the complete filtered sample; `topTweets` is the 10 most influential posts. Its own product (Market Sentiment), with its own key. Cached ~30 min per market.

Use it toRead the mood of a whole market (risk-on/off, gold, crypto) before positioning.

Coverage

Universe

9 markets — US, gold, silver, BTC, ETH, oil, DXY, copper, bonds

History

Latest ~72 hours

Updates

On demand · ~30 min cache

Source

X (Twitter) + DeepSeek AI

Call it

Send your ra_live_… key in the x-api-key header. Pick your language:

curl "https://raspberrytrades.com/api/market-sentiment?market=btc" \
  -H "x-api-key: ra_live_your_key_here"

Parameters

Parameter	Type	Description
`market`	string	us \| gold \| silver \| btc \| eth \| oil \| dollar \| copper \| bonds — omit for all (optional)
`fresh`	0 \| 1	1 = bypass the 30-min cache and read live now (optional)
`x-api-key`	header	Your API key — market scope (required)

Example response

200 OK · application/json

{
  "id": "btc", "name": "Bitcoin", "emoji": "₿",
  "updatedAt": "2026-07-01T12:00:00Z",
  "windowHours": 72,
  "sampleSize": 40,
  "sample": { "target": 40, "total": 40, "shortfall": 0, "curated": 24, "search": 16, "distinctAuthors": 14, "curatedAuthors": 6, "searchAuthors": 8 },
  "sourceHealth": { "status": "healthy", "curated": { "attempted": 8, "succeeded": 8, "failed": 0 }, "search": { "attempted": 1, "succeeded": 1, "failed": 0 } },
  "quality": { "status": "ok", "confidence": "high", "score": 0.89, "classificationMode": "ai", "aiClassified": 40, "warnings": [] },
  "sentiment": { "label": "bearish", "score": -0.23, "bullish": 10, "bearish": 21, "neutral": 9, "basis": "X sentiment only; price action reported separately" },
  "priceAction": { "proxy": "BTC-USD", "changePct": 1.2 },
  "aiSummary": "El mercado mantiene un sesgo bajista tras perder soporte, aunque las compras institucionales y los objetivos cercanos a $92k sostienen el argumento de rebote. Predomina la cautela hasta recuperar el nivel técnico señalado por los traders.",
  "bullSummary": "Institutional adoption: a UAE bank bought $137M BTC on the dip; targets near $92k.",
  "bearSummary": "Price broke key support; traders warn of further downside before a bounce.",
  "topTweets": [
    {
      "author": "PeterLBrandt",
      "text": "BTC losing this level opens the door lower",
      "sentiment": "bearish",
      "origin": "curated",
      "ageHours": 2.8,
      "createdAt": "Wed Jul 01 09:12:00 +0000 2026",
      "url": "https://x.com/PeterLBrandt/status/..."
    }
  ],
  "cached": true, "stale": false, "ageSeconds": 120
}

Sentiment — related datasets

Stock SentimentWhether traders on X are bullish or bearish on any US stock, right now.Breakout RadarThe breakout setups trusted X traders are flagging now — validated against the chart, graded and scored.Sentiment History & TrendWhether the mood on a stock is improving or worsening over time — a sentiment trend line.

Get your API key

Create a free account, copy your ra_live_… key and make your first call to https://raspberrytrades.com/api/market-sentiment.

Keep your key on your server — never ship it in front-end code.