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

Приходы цикла хайпа

GET /clusters/comparison/hype-cycles
CompareHypeCycles

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

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

Параметры

asset_class array<string> QUERY

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

Default:equity,commodity,index,crypto

days integer QUERY

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

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

Default:30

limit integer QUERY

Максимальное число возвращаемых хайп-циклов: крупнейшие по постам в их пиковый день.

Default:40

Пример cURL

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/comparison/hype-cycles' \
  --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 был опущен.

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

Крупнейшие хайп-циклы окна, начиная с самого недавнего пика, до limit.
cycles[].arrivals
array<object> обязательный

Каждый кластер с 3 или больше постами за 48 часов вокруг пикового часа, начиная с самого раннего.
cycles[].arrivals[].cluster_id
string обязательный

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

cycles[].arrivals[].offset_hours
number (double) обязательный

Часы от пикового часа рынка до среднего часа постов кластера, взвешенного по постам, за 48 часов вокруг него. Отрицательное значение — до пика.

cycles[].arrivals[].posts
integer (int64) обязательный

Посты кластера по активу за 48 часов вокруг пикового часа.

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

Класс актива: equity (акции и ETF), commodity, index или crypto. Передавайте его вместе с asset_id в каждом запросе, ограниченном активом.

Допустимые значения
equitycommodityindexcrypto
cycles[].asset_id
string обязательный

Канонический публичный идентификатор актива: тикер или рыночный символ для акций, товаров и индексов, а для криптовалют — слаг CoinGecko (или, при его отсутствии, числовой id).

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

Понятное человеку название.

cycles[].peak_day_posts
integer (int64) обязательный

Посты рынка по активу в пиковый день, без ботов.

cycles[].peak_timestamp
string (date-time) обязательный

Начало по UTC самого оживлённого часа рынка в пиковый день.

cycles[].series
array<object> обязательный

Посты рынка по активу час за часом, от 24 часов до пикового часа до 23 часов после него: 48 наблюдений.
cycles[].series[].posts
integer (int32) обязательный

Посты рынка по активу за час, без ботов.

cycles[].series[].timestamp
string (date-time) обязательный

Начало часа по UTC.

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

Отображаемый тикер или рыночный символ.

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

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

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cycles": [
    {
      "arrivals": [
        {
          "cluster_id": "smart_money",
          "offset_hours": -3.2,
          "posts": 18
        },
        {
          "cluster_id": "team_leaders",
          "offset_hours": -2.1,
          "posts": 9
        },
        {
          "cluster_id": "media",
          "offset_hours": 1.4,
          "posts": 57
        }
      ],
      "asset_class": "equity",
      "asset_id": "ORCL",
      "name": "Oracle Corporation",
      "peak_day_posts": 930,
      "peak_timestamp": "2026-09-10T14:00:00Z",
      "series": [
        {
          "posts": 41,
          "timestamp": "2026-09-10T13:00:00Z"
        },
        {
          "posts": 112,
          "timestamp": "2026-09-10T14:00:00Z"
        },
        {
          "posts": 64,
          "timestamp": "2026-09-10T15:00:00Z"
        }
      ],
      "symbol": "ORCL"
    }
  ],
  "days": 30
}