All docs Nebula docs All endpoints Interactive docs Markdown OpenAPI JSON
  1. REST API
  2. Sentiment

Asset Fear and Greed index

GET /fear-greed-index
GetFearGreedIndex

Returns Nebula's 0–100 Fear and Greed series, current reading, labels, and component methodology for one resolved asset. Asset selectors support equities, commodities, indices, and crypto assets returned by GET /assets; commodity and index IDs use asset_class=equity.

Parameters

asset_id string QUERY required

Canonical identifier returned by /assets. Stock, commodity, and index IDs are normally ticker or market symbols and use asset_class=equity; crypto IDs are canonical crypto slugs. asset_class is mandatory whenever asset_id is present.

Example:NVDA

asset_class string QUERY required

Namespace of asset_id, or the market class for endpoints with a class-scoped global view. Stocks, commodities, and indices use equity. Equity is the documented default only where the endpoint description states a default.

Allowed values
equitycrypto

Example:equity

hours integer QUERY

Lookback window in hours.

Default:720

granularity string QUERY

Requested time-series bucket size. When omitted, the service chooses a bucket size appropriate for the lookback window.

Allowed values
1h2h4h12h1d

Example:1h

cURL Example

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/fear-greed-index' \
  --data-urlencode 'asset_id=NVDA' \
  --data-urlencode 'asset_class=equity' \
  --header 'X-API-Key: YOUR_API_KEY'

Responses

200 OK
400 Bad Request
401 Unauthorized
402 Credit balance exhausted
403 Forbidden
404 Not Found
429 Too Many Requests
500 Internal Server Error
503 Service Unavailable

Media type application/json

current
object required

Most recent value for each returned series or the current index reading.
current.index
number (double) required

Nebula index value on a 0–100 scale.

current.label
string required

Human-readable bucket or index label.

metadata
object optional

Methodology and request-window metadata needed to interpret the response.
metadata.components
array<object> required

Weighted components used to calculate the index.
metadata.components[].description
string required

Human-readable explanation of this component.

metadata.components[].name
string required

Human-readable name.

metadata.components[].weight
number (double) required

Component weight as a decimal fraction.

metadata.hours
integer required

Lookback window represented by the response, in hours.

metadata.labels
array<string> required

Ordered labels used to interpret index ranges.

metadata.scale
string required

Published scale or interpretation of the metric.

series
array<object> required

Chronologically ordered observations.
series[].index
number (double) required

Nebula index value on a 0–100 scale.

series[].label
string required

Human-readable bucket or index label.

series[].timestamp
string (date-time) required

UTC RFC 3339 timestamp for the observation or bucket start.

{
  "current": {
    "index": 67.4,
    "label": "Greed"
  },
  "series": [
    {
      "index": 67.4,
      "label": "Greed",
      "timestamp": "2026-08-07T15:00:00Z"
    }
  ]
}