Contents

Blockmetric Sentiment index

Blockmetric Sentiment: our own 0–100 market sentiment index (0 extreme fear, 100 extreme greed) from data we collect: BTC price momentum and volatility, funding of BTC and ETH perpetuals on Binance and Bybit, BTC open interest change, the Binance long/short account ratio, the liquidation imbalance and the positioning of tracked Hyperliquid whales.

GET/api/v1/sentimentEvery key

Description

Every input is ranked against its own daily values of the previous 365 days and weighted (method, /methodology#sentiment); an input without enough history or data is left out and the others are renormalised (status collecting, missing or off). Returns the current value (recomputed every 15 minutes; daily = true when it is the latest 00:00 UTC value) with the score and points of every input, and the daily history at 00:00 UTC. Inputs leave only as scores, never as raw values.

Who can call it

Available with every key and keyless (X-Blockmetric-Access: public). Keys of Free accounts get free-tier data (real-time feeds, 30 days of history, heatmap over time for every coin over the last 24 hours, liquidation levels now for every coin, the same as the free web plan); Pro and Desk keys the data of their plan; API Dev / API Pro raise the limits.

No key: 24 h
Free: 30 days
Pro: 365 days
Desk: 1095 days
API Dev: 365 days
API Pro: 1095 days

History window per plan. Limits: Authentication & limits.

Parameters

Parameters of /sentiment
Parameter	Description
`days`integer	Days of daily history, default 90, clamped to 1–1095 and to the plan history (free key 30 days, keyless 24 h).1–1095 · default 90

Response fields

Every success is { data, meta }; these are the fields of data. meta is the same on every endpoint.

Response fields of /sentiment
Field	Description
`name`string	Always "Blockmetric Sentiment".
`current`object · nullable	Current value with its breakdown; null while less than method.minWeight of the weight has enough history.
`current.at`string (ISO 8601)	Time of the value.
`current.score`number	0–100.
`current.label`"Extreme fear" \| "Fear" \| "Neutral" \| "Greed" \| "Extreme greed"	-
`current.daily`boolean	true: no fresh intraday value, this is the latest daily value at 00:00 UTC.
`current.weightUsed`integer	Sum of the weights of the inputs that counted (of 100; at least method.minWeight).
`current.components[]`array of objects	Affected parts of the service.
`current.components[].id`string (enum)	Stable id of the item; on paginated feeds the order key together with ts.
`current.components[].name`string	Name of the input, e.g. "Price momentum".
`current.components[].weight`integer	Fixed weight of the input (of 100).
`current.components[].status`"ok" \| "collecting" \| "missing" \| "off"	ok = counted; collecting = fewer than method.minSamples earlier daily values; missing = no data for the period; off = a source of it is switched off.
`current.components[].samples`integer	Earlier daily values in the 365-day lookback.
`current.components[].score`number · nullable	0–100: percentile against its own lookback (volatility inverted); null unless ok.
`current.components[].points`number · nullable	Points this input adds to the total (weight renormalised over the counted inputs); null unless ok.
`history[]`array of objects	Daily values at 00:00 UTC, oldest first; days without a score are left out.
`history[].day`string	UTC date of the 00:00 value (YYYY-MM-DD).
`history[].at`string (ISO 8601)	00:00 UTC of that day.
`history[].score`number	0–100.
`history[].label`"Extreme fear" \| "Fear" \| "Neutral" \| "Greed" \| "Extreme greed"	-
`history[].weightUsed`integer	Sum of the weights of the inputs that counted (of 100).
`firstDay`string · nullable	First day with a score.
`method`object	The fixed rules of the index (/methodology#sentiment).
`method.lookbackDays`integer	Days of daily values every input is ranked against.
`method.minSamples`integer	Earlier daily values an input needs before it counts.
`method.minWeight`integer	Minimum weight (of 100) of the counted inputs for a value.
`method.bands[]`array of objects	Label bands on the rounded score.
`method.bands[].from`integer	Lowest rounded score of the band.
`method.bands[].to`integer	Highest rounded score of the band.
`method.bands[].label`"Extreme fear" \| "Fear" \| "Neutral" \| "Greed" \| "Extreme greed"	-

Errors

400invalid_param Invalid parameter
401unauthorized Missing or invalid API key
403plan_required Plan does not include this
403scope_required Key not scoped for this API
403ip_not_allowed Address not on the IP allowlist of the key
403origin_not_allowed Key used from a browser origin it does not allow
403source_restricted Exchange data not redistributed
403https_required https required
429rate_limited Per-minute limit reachedretry
429daily_limit_exceeded Daily limit reachedretry
429stream_limit Too many open streamsretry
500internal_error Internal errorretry

Request

curl -s -H "X-Blockmetric-Access: public" \
  "https://api.blockmetric.io/v1/sentiment?days=30"

Example response

HTTP 200Real data from 2026-10-28 00:23 UTC

{
  "data": {
    "name": "Blockmetric Sentiment",
    "current": {
      "at": "2026-10-28T00:23:56.224Z",
      "score": 72.6,
      "label": "Greed",
      "daily": false,
      "weightUsed": 85,
      "components": [
        {
          "id": "momentum",
          "name": "Price momentum",
          "weight": 25,
          "status": "ok",
          "samples": 365,
          "score": 46.6,
          "points": 13.7
        },
        {
          "id": "volatility",
          "name": "Volatility",
          "weight": 15,
          "status": "ok",
          "samples": 365,
          "score": 97.3,
          "points": 17.2
        }
      ]
    },
    "history": [
      {
        "day": "2026-10-26",
        "at": "2026-10-26T00:00:00.000Z",
        "score": 72.8,
        "label": "Greed",
        "weightUsed": 85
      },
      {
        "day": "2026-10-27",
        "at": "2026-10-27T00:00:00.000Z",
        "score": 73.1,
        "label": "Greed",
        "weightUsed": 85
      }
    ],
    "firstDay": "2025-10-15",
    "method": {
      "lookbackDays": 365,
      "minSamples": 21,
      "minWeight": 50,
      "bands": [
        {
          "from": 0,
          "to": 24,
          "label": "Extreme fear"
        },
        {
          "from": 25,
          "to": 44,
          "label": "Fear"
        }
      ]
    }
  },
  "meta": {
    "updatedAt": "2026-10-28T00:23:56.224Z",
    "source": "hyperliquid,binance,bybit",
    "sources": [
      "hyperliquid",
      "binance"
    ],
    "plan": "api_dev",
    "delayMinutes": 0,
    "commercial": false,
    "license": {
      "id": "internal",
      "display": false,
      "attributionRequired": false,
      "attribution": null,
      "redistribution": false,
      "mauCap": null,
      "terms": "https://blockmetric.io/terms#api-license"
    },
    "attribution": {
      "text": "Data by Blockmetric · Source: Blockmetric Research · Binance · Bybit",
      "url": "https://blockmetric.io/"
    },
    "access": {
      "historyDays": 365,
      "historyFrom": "2025-10-28T00:24:00.000Z"
    }
  }
}

Lists shortened to their first items (1 more in the real response).

More options: open in the explorer · SDK method sentiment() / sentiment()

Code snippets in these docs are licensed under MIT-0: copy them into your own code without attribution. The SDKs, CLI and MCP server will be, once published, Apache-2.0; the name Blockmetric is not licensed (forks must be renamed). Data from the API is governed by the API terms; third-party exchange data by the exchange’s terms.