Вся документация Документация Nebula Все эндпоинты Интерактивная документация Markdown OpenAPI JSON

REST API
Кластеры

Ротация кластеров

GET /clusters/rotation

GetClusterRotation

Куда смещается внимание кластера: активы, набирающие и теряющие долю его постов по сравнению с предыдущим окном, в базисных пунктах, а также распределение его постов по рынкам, людям и событиям.

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

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

Оплата кошельком доступна на https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/rotation. Аккаунт 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

hours integer QUERY

Окно для сравнения с предшествующим окном той же длины: 24 (последние 24 часа), 168 (последние 7 полных дней) или 720 (последние 30 полных дней). Бесплатные планы охватывают 90 дней; более ранние данные возвращают 403.

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

24168720

Default:168

limit integer QUERY

Максимум возвращаемых растущих активов и отдельно максимум падающих.

Default:6

Пример cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/rotation' \
  --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.

gainers

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

Активы, чья доля постов кластера выросла сильнее всего, сначала наибольший рост. Перечисляются только активы, чья доля выросла.

gainers[].asset_class

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

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

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

equitycommodityindexcrypto

gainers[].asset_id

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

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

gainers[].current_share

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

Доля постов среди всех постов кластера о выбранных классах активов в текущем окне, от 0 до 1.

gainers[].name

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

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

gainers[].previous_share

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

Доля постов об активе среди всех постов кластера в окне сравнения, от 0 до 1.

gainers[].share_change_bps

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

current_share минус доля в окне сравнения, в базисных пунктах: 100 — это один процентный пункт. Отрицательное значение означает, что доля упала.

gainers[].symbol

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

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

hours

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

Окно ретроспективы, представленное ответом, в часах.

losers

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

Активы, чья доля постов кластера упала сильнее всего, сначала наибольшее падение. Перечисляются только активы, чья доля упала.

losers[].asset_class

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

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

equitycommodityindexcrypto

losers[].asset_id

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

losers[].current_share

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

Доля постов среди всех постов кластера о выбранных классах активов в текущем окне, от 0 до 1.

losers[].name

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

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

losers[].previous_share

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

Доля постов об активе среди всех постов кластера в окне сравнения, от 0 до 1.

losers[].share_change_bps

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

losers[].symbol

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

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

topic_changes

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

Доля каждой темы в текущем окне и её изменение относительно предыдущего, в порядке: equity, commodity, index, crypto, people, events.

topic_changes[].current_share

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

Доля постов кластера по этой теме в текущем окне, от 0 до 1.

topic_changes[].share_change_bps

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

Изменение доли относительно предыдущего окна, в базисных пунктах (100 — это один процентный пункт).

topic_changes[].topic

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

equity, commodity, index, crypto, people (люди и их аккаунты) или events (места, темы и события).

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

equitycommodityindexcryptopeopleevents

topic_series

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

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

topic_series[].timestamp

string (date-time) обязательный

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

topic_series[].topics

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

Доля постов кластера по каждой теме в этот день, в порядке topic_changes. Доли в сумме дают 1, если в этот день кластер публиковал посты.

topic_series[].topics[].topic

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

equity, commodity, index, crypto, people (люди и их аккаунты) или events (места, темы и события).

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

equitycommodityindexcryptopeopleevents

topic_series[].topics[].topic_share

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

Доля постов кластера по этой теме в этот день, от 0 до 1.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "gainers": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "current_share": 0.0687,
      "name": "NVIDIA Corporation",
      "previous_share": 0.0412,
      "share_change_bps": 275,
      "symbol": "NVDA"
    }
  ],
  "hours": 168,
  "losers": [
    {
      "asset_class": "equity",
      "asset_id": "TSLA",
      "current_share": 0.0318,
      "name": "Tesla, Inc.",
      "previous_share": 0.0521,
      "share_change_bps": -203,
      "symbol": "TSLA"
    }
  ],
  "topic_changes": [
    {
      "current_share": 0.52,
      "share_change_bps": 120,
      "topic": "equity"
    },
    {
      "current_share": 0.03,
      "share_change_bps": -15,
      "topic": "commodity"
    },
    {
      "current_share": 0.04,
      "share_change_bps": 10,
      "topic": "index"
    },
    {
      "current_share": 0.14,
      "share_change_bps": -115,
      "topic": "crypto"
    },
    {
      "current_share": 0.11,
      "share_change_bps": 35,
      "topic": "people"
    },
    {
      "current_share": 0.16,
      "share_change_bps": -35,
      "topic": "events"
    }
  ],
  "topic_series": [
    {
      "timestamp": "2026-09-10T00:00:00Z",
      "topics": [
        {
          "topic": "equity",
          "topic_share": 0.5
        },
        {
          "topic": "commodity",
          "topic_share": 0.03
        },
        {
          "topic": "index",
          "topic_share": 0.04
        },
        {
          "topic": "crypto",
          "topic_share": 0.15
        },
        {
          "topic": "people",
          "topic_share": 0.11
        },
        {
          "topic": "events",
          "topic_share": 0.17
        }
      ]
    },
    {
      "timestamp": "2026-09-11T00:00:00Z",
      "topics": [
        {
          "topic": "equity",
          "topic_share": 0.53
        },
        {
          "topic": "commodity",
          "topic_share": 0.03
        },
        {
          "topic": "index",
          "topic_share": 0.04
        },
        {
          "topic": "crypto",
          "topic_share": 0.13
        },
        {
          "topic": "people",
          "topic_share": 0.11
        },
        {
          "topic": "events",
          "topic_share": 0.16
        }
      ]
    }
  ]
}