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

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

GET /clusters/comparison
CompareClusters

Все кластеры авторов рядом друг с другом за окно: публикации и их изменение, насколько кластер бычий относительно рынка (cluster_bullish_share против market_bullish_share), актив, к которому он чаще всего обращался за последние 7 дней (trending_asset), и ежедневные публикации.

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

Параметры

asset_class array<string> QUERY

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

Default:equity,commodity,index,crypto

days integer QUERY

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

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

Default:30

Пример cURL

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

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

Все кластеры с публикациями в окне, сначала с наибольшим числом публикаций.
clusters[].activity_change_pct
number (double) обязательный

Изменение числа публикаций в процентах относительно предыдущего окна равной длины (76 публикаций после 84 — это -9,52); отсутствует, когда сравнение невозможно.

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

Медвежьи публикации кластера за окно.

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

Бычьи публикации кластера за окно.

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

Бычьи публикации кластера ÷ (бычьи + медвежьи) за окно, от 0 до 1. Null при отсутствии бычьих или медвежьих публикаций.

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

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

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

Та же доля для рынка, который читает кластер, за те же дни и классы активов (рынок equity для сообщества публикаций): базовая величина, с которой сравнивается cluster_bullish_share. Null при отсутствии бычьих или медвежьих публикаций.

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

Публикации кластера за окно.

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

Каждый полный календарный день UTC в окне, от самого раннего к самому позднему; дни без постов включены.
clusters[].series[].bearish_posts
integer (int64) обязательный

Медвежьи посты кластера за день.

clusters[].series[].bullish_posts
integer (int64) обязательный

Бычьи посты кластера за день.

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

Посты кластера за день.

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

Начало дня по UTC: 00:00.

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

Актив, к которому кластер обращался чаще, чем рынок, за последние 7 полных дней; null, если такого нет.
clusters[].trending_asset.asset_class
string обязательный

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

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

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

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

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

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

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

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

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

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "clusters": [
    {
      "activity_change_pct": 7.61,
      "bearish_posts": 13550,
      "bullish_posts": 61240,
      "cluster_bullish_share": 0.8188,
      "cluster_id": "media",
      "market_bullish_share": 0.7812,
      "posts": 173412,
      "series": [
        {
          "bearish_posts": 480,
          "bullish_posts": 2210,
          "posts": 6120,
          "timestamp": "2026-09-11T00:00:00Z"
        },
        {
          "bearish_posts": 512,
          "bullish_posts": 2102,
          "posts": 5874,
          "timestamp": "2026-09-12T00:00:00Z"
        }
      ],
      "trending_asset": {
        "asset_class": "equity",
        "asset_id": "NVDA",
        "name": "NVIDIA Corporation",
        "symbol": "NVDA"
      }
    },
    {
      "activity_change_pct": 171.42,
      "bearish_posts": 18860,
      "bullish_posts": 20480,
      "cluster_bullish_share": 0.5206,
      "cluster_id": "wallstreetbets",
      "market_bullish_share": 0.7035,
      "posts": 88034,
      "series": [
        {
          "bearish_posts": 702,
          "bullish_posts": 790,
          "posts": 3310,
          "timestamp": "2026-09-11T00:00:00Z"
        },
        {
          "bearish_posts": 681,
          "bullish_posts": 655,
          "posts": 2987,
          "timestamp": "2026-09-12T00:00:00Z"
        }
      ],
      "trending_asset": {
        "asset_class": "equity",
        "asset_id": "ORCL",
        "name": "Oracle Corporation",
        "symbol": "ORCL"
      }
    }
  ],
  "days": 30
}