Solapamiento de clústeres

GET /clusters/overlap
GetClusterOverlap

Qué clústeres siguen los mismos activos que este y si coinciden. overlap_share es la proporción de sus 50 principales activos que comparte un par; direction_agreement_share es la frecuencia con la que se inclinan en el mismo sentido; stance_gap es positivo cuando este clúster es el más alcista.

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/overlap. 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 el enfoque, 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

Ejemplo de cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/overlap' \
  --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.

cluster_id
string obligatorio

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

days
integer obligatorio

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

peers
array<object> obligatorio

Todos los demás clústeres activos, los de mayor solapamiento primero.

peers[].agreeing_asset_count
integer obligatorio

Activos comparados en los que ambos clústeres se inclinan en el mismo sentido respecto al mercado.

peers[].cluster_id
string obligatorio

Identificador canónico del clúster de autores.

peers[].compared_asset_count
integer obligatorio

Activos compartidos, en todo el solapamiento, en los que ambos clústeres se inclinan al menos 0.05 respecto a la postura del mercado.

peers[].direction_agreement_share
number (double) obligatorio

En los activos compartidos en los que ambos clústeres se inclinan al menos 0.05 respecto a la postura del mercado, la proporción en la que se inclinan en el mismo sentido: agreeing_asset_count ÷ compared_asset_count. Null con menos de 3 activos.

peers[].overlap_share
number (double) obligatorio

Proporción del conjunto de enfoque de este clúster que también está en el del par, de 0 a 1.

peers[].shared_assets
array<object> obligatorio

Hasta 5 activos en ambos conjuntos de enfoque, en el orden de atención de este clúster.

peers[].shared_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
peers[].shared_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.

peers[].shared_assets[].cluster_stance
number (double) obligatorio

La postura neta de este clúster sobre el activo, de −1 a +1. Null con menos de 3 publicaciones alcistas o bajistas.

peers[].shared_assets[].market_stance
number (double) obligatorio

La postura neta del mercado sobre el activo, de −1 a +1: la línea base con la que se miden ambas inclinaciones. Null con menos de 3 publicaciones alcistas o bajistas.

peers[].shared_assets[].name
string obligatorio

Nombre legible para personas.

peers[].shared_assets[].peer_stance
number (double) obligatorio

La postura neta del par sobre el activo, de −1 a +1. Null con menos de 3 publicaciones alcistas o bajistas.

peers[].shared_assets[].symbol
string obligatorio

Ticker o símbolo de mercado para mostrar.

peers[].stance_gap
number (double) obligatorio

La postura de este clúster menos la del par, promediada sobre los activos compartidos en los que ambos tienen postura, de −2 a +2. Positivo significa que este clúster es más alcista. Null con menos de 3 activos.

top_asset_count
integer obligatorio

Tamaño del conjunto de enfoque de cada clúster: sus activos más comentados, hasta este número.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "days": 30,
  "peers": [
    {
      "agreeing_asset_count": 11,
      "cluster_id": "fa_analyst",
      "compared_asset_count": 17,
      "direction_agreement_share": 0.6471,
      "overlap_share": 0.62,
      "shared_assets": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "cluster_stance": 0.62,
          "market_stance": 0.41,
          "name": "NVIDIA Corporation",
          "peer_stance": 0.54,
          "symbol": "NVDA"
        },
        {
          "asset_class": "equity",
          "asset_id": "AMZN",
          "cluster_stance": 0.48,
          "market_stance": 0.3,
          "name": "Amazon.com, Inc.",
          "peer_stance": null,
          "symbol": "AMZN"
        }
      ],
      "stance_gap": 0.0812
    },
    {
      "agreeing_asset_count": 5,
      "cluster_id": "kols",
      "compared_asset_count": 12,
      "direction_agreement_share": 0.4167,
      "overlap_share": 0.46,
      "shared_assets": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "cluster_stance": 0.62,
          "market_stance": 0.41,
          "name": "NVIDIA Corporation",
          "peer_stance": 0.71,
          "symbol": "NVDA"
        },
        {
          "asset_class": "equity",
          "asset_id": "TSLA",
          "cluster_stance": -0.35,
          "market_stance": 0.22,
          "name": "Tesla, Inc.",
          "peer_stance": 0.28,
          "symbol": "TSLA"
        }
      ],
      "stance_gap": -0.1375
    }
  ],
  "top_asset_count": 50
}