Вся документация Документация Nebula Все эндпоинты Интерактивная документация Markdown OpenAPI JSON
  1. REST API
  2. Кластеры

Сравнение признаков кластеров

GET /clusters/comparison/traits
CompareClusterTraits

Каждая характеристика /clusters/profile по всем кластерам, начиная с наибольшей, чтобы увидеть, какие группы лидируют или отстают по каждой из них.

Оплата кошельком доступна на https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/comparison/traits. Аккаунт Nebula или API-ключ не требуются; проверьте предложение об оплате перед подписанием. Руководство по оплате x402.

Параметры

asset_class array<string> QUERY

Рынки для сравнения: любой из equity, commodity, index и crypto, через запятую. По умолчанию все четыре. Можно указать несколько через запятую.

Default:equity,commodity,index,crypto

days integer QUERY

За сколько полных дней UTC анализировать, отсчитывая назад от последнего полного дня: 30 или 90. Более длинные окна охватывают больше хайп-циклов, поэтому характеристики циклов устойчивее. Бесплатные тарифы охватывают 90 дней; при большем значении возвращается 403.

Допустимые значения
3090

Default:90

Пример cURL

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/comparison/traits' \
  --header 'X-API-Key: YOUR_API_KEY'

Ответы

200 OK
400 Некорректный запрос
401 Не авторизован
402 Кредиты израсходованы; ответ содержит срок продления и баланс купленных кредитов
403 Доступ запрещён
404 Не найдено
405 Метод не поддерживается; поддерживаемые методы перечислены в заголовке Allow
429 Слишком много запросов
500 Внутренняя ошибка сервера
503 Сервис недоступен

Тип медиа application/json

active_clusters
integer обязательный

Кластеры, активные в окне: внутри них ранжируются характеристики популяции.

asset_classes
array<string> обязательный

Проанализированные рынки в порядке equity, commodity, index, crypto: запрошенные значения asset_class или все четыре, если asset_class был опущен.

days
integer обязательный

Длина окна в полных днях UTC, заканчивающегося последним полным днём.

hype_cycles
integer обязательный

Хайп-циклы рынка в окне: активы, посты по которым достигали пика в 50 или больше за день и как минимум в 3 раза превышали их медианный день.

traits
array<object> обязательный

По одной записи на характеристику, в порядке earliness, contrarian, hype_fade, conviction, focus, breadth, bullishness, discovery, turnover, coverage.
traits[].clusters
array<object> обязательный

Каждый кластер со значением характеристики, начиная с наибольшего.
traits[].clusters[].cluster_id
string обязательный

Канонический идентификатор кластера авторов.

traits[].clusters[].value
number (double) обязательный

Значение характеристики для кластера, в unit.

traits[].trait
string обязательный

Измеряемая характеристика; описание операции определяет каждую из них.

Допустимые значения
earlinesscontrarianhype_fadeconvictionfocusbreadthbullishnessdiscoveryturnovercoverage
traits[].unit
string обязательный

дней, доля (от 0 до 1) или количество; фиксировано для каждого признака.

Допустимые значения
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"
    }
  ]
}