Conviction index

GET /conviction-index

GetConvictionIndex

A 0–100 reading of how strongly people believe in an asset. It combines the asset's bullish ratio against the market's, how far sentiment holds up while price falls, the latest bullish ratio, and greed-type emotions. Around 50 is typical; compare an asset with its own history.

Wallet payment available at https://nebula-api.hiddensystems.ai/api/v1/x402/conviction-index. No Nebula account or API key required; check the payment offer before signing. x402 payment guide.

Parameters

asset_id string QUERY required

Asset ID from /assets or /search, such as NVDA, GLD, SPX, or bitcoin. Send it with the asset_class returned alongside it.

Example:NVDA

asset_class string QUERY required

Class of the asset named by asset_id: equity (stocks and ETFs), commodity, index, or crypto. Send the asset_class that /assets or /search returned alongside the asset_id.

Allowed values

equitycommodityindexcrypto

Example:equity

hours integer QUERY

Lookback window in hours. Free plans reach back 90 days; further returns 403.

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/conviction-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 Credits used up; response includes renewal timing and purchased credit balance

403 Forbidden

404 Not Found

405 Method not allowed; the Allow header lists the supported method

429 Too Many Requests

500 Internal Server Error

503 Service Unavailable

Media type application/json

series

array<object> required

Chronologically ordered observations.

series[].index

number (double) required

Nebula index value on a 0–100 scale.

series[].timestamp

string (date-time) required

UTC RFC 3339 timestamp for the observation or bucket start.

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