Tutta la documentazione Documentazione di Nebula Tutti gli endpoint Documentazione interattiva Markdown JSON OpenAPI
  1. API REST
  2. Sentiment di mercato

Indice Fear and Greed

GET /fear-greed-index
GetFearGreedIndex

Una lettura giornaliera da 0 a 100 di paura e avidità per un asset, che combina prezzo, volatilità, momentum, volume di scambi e umore social: fino a 20 Extreme Fear, 40 Fear, 60 Neutral, 80 Greed, oltre 80 Extreme Greed. metadata elenca i componenti.

Pagamento con wallet disponibile su https://nebula-api.hiddensystems.ai/api/v1/x402/fear-greed-index. Non sono richiesti un account Nebula o una chiave API; controlla l'offerta di pagamento prima di firmare. Guida al pagamento x402.

Parametri

asset_id string QUERY obbligatorio

Asset ID da /assets o /search, ad esempio NVDA, GLD, SPX o bitcoin. Va inviato con l'asset_class restituito insieme ad esso.

Example:NVDA

asset_class string QUERY obbligatorio

Classe dell'asset indicato da asset_id: equity (azioni ed ETF), commodity, index o crypto. Va inviata l'asset_class restituita da /assets o /search insieme all'asset_id.

Valori consentiti
equitycommodityindexcrypto

Example:equity

hours integer QUERY

Finestra di lookback in ore. I piani gratuiti risalgono fino a 90 giorni; oltre viene restituito 403.

Default:720

granularity string QUERY

Dimensione del bucket della serie temporale richiesta. Se omessa, il servizio sceglie una dimensione del bucket adeguata alla finestra di lookback.

Valori consentiti
1h2h4h12h1d

Example:1h

Esempio cURL

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'

Risposte

200 OK
400 Richiesta non valida
401 Non autorizzato
402 Crediti esauriti; la risposta include i tempi di rinnovo e il saldo dei crediti acquistati
403 Vietato
404 Non trovato
405 Metodo non consentito; l'header Allow elenca il metodo supportato
429 Troppe richieste
500 Errore interno del server
503 Servizio non disponibile

Tipo di media application/json

current
object obbligatorio

Valore più recente per ciascuna serie restituita o lettura corrente dell'indice.
current.index
number (double) obbligatorio

Valore dell'indice Nebula su una scala da 0 a 100.

current.label
string obbligatorio

Etichetta leggibile del bucket o dell'indice.

metadata
object opzionale

Metodologia e metadati della finestra di richiesta necessari per interpretare la risposta.
metadata.components
array<object> obbligatorio

Componenti ponderate utilizzate per calcolare l'indice.
metadata.components[].description
string obbligatorio

Spiegazione leggibile di questo componente.

metadata.components[].name
string obbligatorio

Nome leggibile.

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

Peso del componente come frazione decimale.

metadata.hours
integer obbligatorio

Finestra di lookback rappresentata dalla risposta, in ore.

metadata.labels
array<string> obbligatorio

Etichette ordinate utilizzate per interpretare gli intervalli dell'indice.

metadata.scale
string obbligatorio

Scala pubblicata o interpretazione della metrica.

series
array<object> obbligatorio

Osservazioni ordinate cronologicamente.
series[].index
number (double) obbligatorio

Valore dell'indice Nebula su una scala da 0 a 100.

series[].label
string obbligatorio

Etichetta leggibile del bucket o dell'indice.

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

Timestamp UTC in formato RFC 3339 per l'osservazione o l'inizio del bucket.

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