GET /sentiment

GET /sentiment

$0.01 USDC

One market-wide sentiment label. A collector reads up to eight inputs (the Crypto Fear & Greed Index, Hyperliquid funding, news headlines, DefiLlama on-chain data, FRED macro series, CoinGecko market data, and two inputs that currently produce nothing). The label is the equal-weight mean of the inputs that are live, bucketed; the raw score is never returned. sources_live says how many inputs it rests on.

Request

GET https://api.cerebruspulse.xyz/sentiment

No parameters.

Response

Field	Type	Description
endpoint	string	sentiment
sentiment.label	string	very_bearish (mean ≤ −0.5), bearish (≤ −0.15), neutral (≤ 0.15), bullish (≤ 0.5), very_bullish, or unknown when no input is live or the collector’s file cannot be read
sentiment.as_of	number	When the collector last wrote (Unix seconds); 0 when unknown
sentiment.composite_method	string	live_mean (the mean of the live inputs, the default) or collector (the collector’s own weighted composite)
sentiment.sources_live	string	Live inputs out of all inputs, e.g. 5/8. An input reading exactly 0 counts as dead
sentiment.live_sources	array	The live inputs, from fear_greed, twitter, funding_sentiment, news_vader, onchain, macro, political, broad_market
meta	object	Common metadata (Response Schemas); meta.sources names the providers of the live inputs only, with any attribution notice they require
meta.offering	string	pulse_sentiment
meta.sources_live	string	The same count as sentiment.sources_live

Example

GET /sentiment: real engine output on market data captured at 2026-09-24 17:05 UTC. Lists are cut to 3 items. Live responses may also carry meta.disclaimer, which the gateway adds.

{
  "endpoint": "sentiment",
  "sentiment": {
    "label": "bullish",
    "as_of": 1790269024.020345,
    "composite_method": "live_mean",
    "sources_live": "5/8",
    "live_sources": [
      "fear_greed",
      "news_vader",
      "onchain"
    ]
  },
  "meta": {
    "provider": "Cerebrus Pulse",
    "offering": "pulse_sentiment",
    "execution_ms": 0,
    "sources_live": "5/8",
    "sources": [
      {
        "name": "Crypto Fear & Greed Index by alternative.me",
        "url": "https://alternative.me/crypto/fear-and-greed-index/"
      },
      {
        "name": "News headlines from Cointelegraph, CoinDesk and Crypto News RSS feeds, scored for sentiment by Cerebrus Pulse"
      },
      {
        "name": "DefiLlama",
        "url": "https://defillama.com"
      },
      {
        "name": "FRED, Federal Reserve Bank of St. Louis",
        "url": "https://fred.stlouisfed.org",
        "notice": "This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis."
      },
      {
        "name": "CoinGecko",
        "url": "https://www.coingecko.com",
        "notice": "Powered by CoinGecko"
      }
    ]
  }
}

Errors

Status	Reason
402	Payment required (the standard x402 flow)
429	Rate limit exceeded
503	Service disabled, payments down, or the sentiment feed is missing or stale; no price is quoted
504	Engine timeout (not charged)