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

Comparación de rasgos de clústeres

GET /clusters/comparison/traits
CompareClusterTraits

Todos los rasgos de /clusters/profile de todos los clústeres, el más alto primero, para ver qué grupos lideran o van por detrás en cada uno.

Pago con wallet disponible en https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/comparison/traits. 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_class array<string> QUERY

Los mercados que se van a comparar: cualquiera de equity, commodity, index y crypto, separados por comas. De forma predeterminada, los cuatro. Envía varios separados por comas.

Default:equity,commodity,index,crypto

days integer QUERY

Cuántos días UTC completos analizar, contando hacia atrás desde el último día completo: 30 o 90. Las ventanas más largas ven más ciclos de hype, por lo que los rasgos de los ciclos son más estables. Los planes gratuitos llegan hasta 90 días atrás; más allá devuelve 403.

Valores permitidos
3090

Default:90

Ejemplo de cURL

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/comparison/traits' \
  --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

active_clusters
integer obligatorio

Clústeres activos en la ventana: los rasgos de población se ordenan dentro de ella.

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.

days
integer obligatorio

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

hype_cycles
integer obligatorio

Ciclos de hype del mercado en la ventana: activos cuyas publicaciones alcanzaron un pico de 50 o más en un día y al menos 3× su día mediano.

traits
array<object> obligatorio

Una entrada por rasgo, en el orden earliness, contrarian, hype_fade, conviction, focus, breadth, bullishness, discovery, turnover, coverage.
traits[].clusters
array<object> obligatorio

Todos los clústeres con un valor para el rasgo, el más alto primero.
traits[].clusters[].cluster_id
string obligatorio

Identificador canónico del clúster de autores.

traits[].clusters[].value
number (double) obligatorio

El valor del clúster para el rasgo, en unit.

traits[].trait
string obligatorio

El rasgo medido; la descripción de la operación define cada uno.

Valores permitidos
earlinesscontrarianhype_fadeconvictionfocusbreadthbullishnessdiscoveryturnovercoverage
traits[].unit
string obligatorio

días, proporción (0 a 1) o recuento; fijo por rasgo.

Valores permitidos
dayssharecount 
{
  "active_clusters": 35,
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "days": 90,
  "hype_cycles": 41,
  "traits": [
    {
      "clusters": [
        {
          "cluster_id": "early_movers",
          "value": 0.0875
        },
        {
          "cluster_id": "smart_money",
          "value": 0.0111
        },
        {
          "cluster_id": "late_movers",
          "value": -0.0917
        }
      ],
      "trait": "earliness",
      "unit": "days"
    },
    {
      "clusters": [
        {
          "cluster_id": "dao_funds",
          "value": 0.9912
        },
        {
          "cluster_id": "smart_money",
          "value": 0.8431
        },
        {
          "cluster_id": "doomers",
          "value": 0.3015
        }
      ],
      "trait": "bullishness",
      "unit": "share"
    }
  ]
}