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

Posturas de clústeres

GET /clusters/stances
GetClusterStances

La postura de un clúster sobre sus activos más comentados junto a la del mercado, de −1 (todo bajista) a +1 (todo alcista). contrarian_share indica con qué frecuencia se inclina en sentido contrario al mercado, con la media de los demás clústeres para comparar.

Reglas de los parámetros:

  • Envía cluster_id.
  • cluster_id nombra un clúster; para comparar varios, llama una vez por clúster o usa /clusters para todos los clústeres a la vez.
  • Las comunidades de publicación (wallstreetbets, reddit) solo cubren acciones: con una de ellas, asset_class debe incluir equity.

Pago con wallet disponible en https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/stances. 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

cluster_id string QUERY obligatorio

El clúster que se va a analizar, tal como lo devuelve /clusters, por ejemplo smart_money o wallstreetbets. Cualquier id del parámetro clusters de /sentiment.

Example:smart_money

asset_class array<string> QUERY

Los mercados que se van a analizar: cualquiera de equity, commodity, index y crypto, separados por comas. Por defecto, los cuatro. Envía varios separados por comas.

Default:equity,commodity,index,crypto

days integer QUERY

Cuántos días UTC completos medir las posturas, contando hacia atrás desde el último día completo: 7, 30 o 90. Los planes gratuitos llegan hasta 90 días atrás; más allá devuelve 403.

Valores permitidos
73090

Default:30

limit integer QUERY

Máximo de activos devueltos.

Default:30

Ejemplo de cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/stances' \
  --data-urlencode 'cluster_id=smart_money' \
  --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

asset_classes
array<string> obligatorio

Los mercados analizados, en el orden equity, commodity, index, crypto: los valores de asset_class solicitados, o los cuatro cuando se omitió asset_class.

assets
array<object> obligatorio

Los activos elegibles más comentados del clúster (3 o más publicaciones del clúster, 20 o más publicaciones del mercado), hasta limit.
assets[].asset_class
string obligatorio

Clase del activo: equity (acciones y ETF), commodity, index o crypto. Envíala junto con asset_id en cada solicitud con alcance de asset.

Valores permitidos
equitycommodityindexcrypto
assets[].asset_id
string obligatorio

Identificador público canónico del activo: el ticker o símbolo de mercado para acciones, commodities e índices, y el slug de CoinGecko (o, si no lo hay, un id numérico) para crypto.

assets[].cluster_posts
integer (int64) obligatorio

Las publicaciones del clúster sobre el activo durante la ventana.

assets[].cluster_stance
number (double) obligatorio

La postura neta del clúster sobre el activo durante la ventana: publicaciones (alcistas − bajistas) / (alcistas + bajistas), de −1 (todo bajista) a +1 (todo alcista).

assets[].market_stance
number (double) obligatorio

La postura neta del mercado sobre el mismo activo en la misma ventana, en la misma escala de −1 a +1, de todos los autores excepto los bots.

assets[].name
string obligatorio

Nombre legible para personas.

assets[].symbol
string obligatorio

Ticker o símbolo de mercado para mostrar.

cluster_id
string obligatorio

El clúster analizado, como su cluster_id canónico.

contrarian_share
number (double) obligatorio

Proporción de activos elegibles en los que el clúster y el mercado se inclinan en sentidos opuestos, ambos al menos a 0,1 de la neutralidad. Null con menos de 5 activos.

days
integer obligatorio

Duración de la ventana en días UTC completos, terminando en el último día completo.

peer_average_contrarian_share
number (double) obligatorio

contrarian_share promediado entre los demás clústeres; null cuando ninguno tiene uno.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "assets": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "cluster_posts": 214,
      "cluster_stance": 0.62,
      "market_stance": 0.41,
      "name": "NVIDIA Corporation",
      "symbol": "NVDA"
    },
    {
      "asset_class": "equity",
      "asset_id": "TSLA",
      "cluster_posts": 137,
      "cluster_stance": -0.35,
      "market_stance": 0.22,
      "name": "Tesla, Inc.",
      "symbol": "TSLA"
    },
    {
      "asset_class": "equity",
      "asset_id": "AMZN",
      "cluster_posts": 96,
      "cluster_stance": 0.48,
      "market_stance": 0.3,
      "name": "Amazon.com, Inc.",
      "symbol": "AMZN"
    }
  ],
  "cluster_id": "smart_money",
  "contrarian_share": 0.1875,
  "days": 30,
  "peer_average_contrarian_share": 0.1123
}