Toda la documentación Documentación de Nebula Todos los endpoints Documentación interactiva Markdown JSON de OpenAPI
  1. API REST
  2. Sentimiento de mercado

Índice de miedo y codicia

GET /fear-greed-index
GetFearGreedIndex

Una lectura diaria de 0 a 100 de miedo frente a codicia para un activo, que combina precio, volatilidad, momentum, volumen de negociación y estado de ánimo social: hasta 20 Extreme Fear, 40 Fear, 60 Neutral, 80 Greed, por encima de 80 Extreme Greed. metadata enumera los componentes.

Pago con wallet disponible en https://nebula-api.hiddensystems.ai/api/v1/x402/fear-greed-index. No se requiere cuenta de Nebula ni clave de API; consulta la oferta de pago antes de firmar. Guía de pago x402.

Parámetros

asset_id string QUERY obligatorio

ID del activo de /assets o /search, como NVDA, GLD, SPX o bitcoin. Envíalo junto con el asset_class que se devolvió con él.

Example:NVDA

asset_class string QUERY obligatorio

Clase del activo nombrado por asset_id: equity (acciones y ETF), commodity, index o crypto. Envía el asset_class que /assets o /search devolvió junto con el asset_id.

Valores permitidos
equitycommodityindexcrypto

Example:equity

hours integer QUERY

Ventana de retroceso en horas. Los planes gratuitos llegan hasta 90 días; más allá devuelve 403.

Default:720

granularity string QUERY

Tamaño de bucket de serie temporal solicitado. Si se omite, el servicio elige un tamaño de bucket adecuado para la ventana de lookback.

Valores permitidos
1h2h4h12h1d

Example:1h

Ejemplo de 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'

Respuestas

200 OK
400 Solicitud incorrecta
401 No autorizado
402 Créditos agotados; la respuesta incluye el momento de renovación y el saldo de créditos comprados
403 Prohibido
404 No encontrado
405 Método no permitido; el encabezado Allow enumera el método admitido
429 Demasiadas solicitudes
500 Error interno del servidor
503 Servicio no disponible

Tipo de medio application/json

current
object obligatorio

Valor más reciente de cada serie devuelta o la lectura actual del índice.
current.index
number (double) obligatorio

Valor del índice Nebula en una escala de 0 a 100.

current.label
string obligatorio

Etiqueta legible del bucket o del índice.

metadata
object opcional

Metadatos de metodología y de la ventana de la solicitud necesarios para interpretar la respuesta.
metadata.components
array<object> obligatorio

Componentes ponderados utilizados para calcular el índice.
metadata.components[].description
string obligatorio

Explicación legible de este componente.

metadata.components[].name
string obligatorio

Nombre legible para personas.

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

Peso del componente como fracción decimal.

metadata.hours
integer obligatorio

Ventana de lookback representada por la respuesta, en horas.

metadata.labels
array<string> obligatorio

Etiquetas ordenadas utilizadas para interpretar los rangos del índice.

metadata.scale
string obligatorio

Escala publicada o interpretación de la métrica.

series
array<object> obligatorio

Observaciones ordenadas cronológicamente.
series[].index
number (double) obligatorio

Valor del índice Nebula en una escala de 0 a 100.

series[].label
string obligatorio

Etiqueta legible del bucket o del índice.

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

Marca de tiempo UTC en formato RFC 3339 para la observación o el inicio del bucket.

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