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

Циклы хайпа кластеров

GET /clusters/hype-cycles
GetClusterHypeCycles

Насколько рано кластер приходит к хайп-циклам по сравнению с рынком. curve — это накопленная доля постов каждой стороны с 7 дней до пика по 7 дней после, поэтому линия, расположенная левее, соответствует более раннему приходу; lead_days — это опережение кластера (положительное значение означает ранний приход), а clusters ранжирует опережение всех кластеров.

Правила параметров:

  • Отправьте cluster_id.
  • cluster_id указывает один кластер; чтобы сравнить несколько, вызывайте метод по одному разу на кластер или используйте /clusters, чтобы получить все кластеры сразу.
  • Сообщества авторов постов (wallstreetbets, reddit) охватывают только акции: при использовании одного из них asset_class должен включать equity.

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

Параметры

cluster_id string QUERY обязательный

Кластер для анализа в том виде, в каком его возвращает /clusters, например smart_money или wallstreetbets. Любой id из параметра clusters метода /sentiment.

Example:smart_money

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 --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/hype-cycles' \
  --data-urlencode 'cluster_id=smart_money' \
  --header 'X-API-Key: YOUR_API_KEY'

Ответы

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

Тип медиа application/json

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

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

cluster_id
string обязательный

Проанализированный кластер в виде его канонического cluster_id.

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

Все кластеры с опережением (5 или более циклов), начиная с самого раннего, включая запрошенный.
clusters[].cluster_id
string обязательный

Кластер в виде его канонического cluster_id.

clusters[].cycles_joined
integer обязательный

Завершённые хайп-циклы, в которых кластер публиковал посты в течение 24 часов от часа рыночного пика.

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

Опережение кластера в днях, вычисляемое как lead_days верхнего уровня. Положительное значение означает ранний приход.

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

Верхняя граница вероятного диапазона lead_days.

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

Нижняя граница вероятного диапазона lead_days.

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

Среднее накопленное нарастание, по одной точке на каждый day_offset от −7 до +7; пусто, если ни один цикл не завершён.
curve[].cluster_cumulative_pct
number (double) обязательный

Доля постов кластера за 15 дней вокруг пика, сделанных к концу этого дня, усреднённая по циклам; 100 при day_offset 7.

curve[].day_offset
integer обязательный

Дней от рыночного пика: отрицательное значение до него, 0 в день пика, положительное после него.

curve[].market_cumulative_pct
number (double) обязательный

То же самое для рынка, по тем же циклам.

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

Завершённые хайп-циклы, к которым присоединился кластер: 3 или более постов в течение 7 дней от пика.

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

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

lead_days
number (double) обязательный

Насколько раньше всех остальных приходят посты кластера в течение 24 часов от часа рыночного пика, в днях. Положительное значение означает ранний приход; null при менее чем 20 циклах.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "clusters": [
    {
      "cluster_id": "wallstreetbets",
      "cycles_joined": 171,
      "lead_days": 0.0542,
      "lead_high_days": 0.0708,
      "lead_low_days": 0.0417
    },
    {
      "cluster_id": "smart_money",
      "cycles_joined": 471,
      "lead_days": 0.0125,
      "lead_high_days": 0.0292,
      "lead_low_days": -0.0083
    },
    {
      "cluster_id": "exchanges",
      "cycles_joined": 466,
      "lead_days": -0.0667,
      "lead_high_days": -0.0542,
      "lead_low_days": -0.0792
    }
  ],
  "curve": [
    {
      "cluster_cumulative_pct": 46.8,
      "day_offset": -1,
      "market_cumulative_pct": 38.2
    },
    {
      "cluster_cumulative_pct": 63.5,
      "day_offset": 0,
      "market_cumulative_pct": 57.9
    },
    {
      "cluster_cumulative_pct": 73.1,
      "day_offset": 1,
      "market_cumulative_pct": 69.4
    }
  ],
  "cycles_joined": 27,
  "days": 90,
  "lead_days": 0.0125
}