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

Кластеры авторов

GET /clusters
ListClusters

Активность и тональность каждого кластера авторов на рынке: публикации, уникальные авторы, изменение относительно предыдущего окна и чистая тональность (бычьи публикации минус медвежьи) с почасовым рядом. asset_class — это equity (по умолчанию) или crypto.

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

Параметры

asset_class string QUERY

Рынок для агрегации: equity (традиционные рынки, охватывающие акции, сырьё и индексы вместе) или crypto.

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

Default:equity

hours integer QUERY

Окно ретроспективы в часах. Бесплатные тарифы охватывают 90 дней; дальше возвращается 403.

Default:24

Пример cURL

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

Ответы

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

Тип медиа application/json

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

Сводки по кластерам авторов для выбранного класса активов.
clusters[].activity_change_pct
number (double) необязательный

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

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

Посты, классифицированные как bearish.

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

Посты, классифицированные как bullish.

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

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

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

Посты, классифицированные как neutral.

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

Количество публикаций в непосредственно предшествующем окне равной длины.

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

Последнее значение почасового ряда тональности: самый недавний час с публикациями.

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

Наблюдения в хронологическом порядке.
clusters[].series[].bearish_posts
number (double) обязательный

Посты, классифицированные как bearish.

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

Посты, классифицированные как bullish.

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

Взвешенные с затуханием чистые бычьи посты: бычьи минус медвежьи. Положительное значение — бычьи настроения, отрицательное — медвежьи, а величина растёт вместе с активностью.

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

Метка времени UTC в формате RFC 3339 для наблюдения или начала интервала.

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

Количество постов за активное окно ретроспективы метрики.

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

Количество постов за активное окно ретроспективы метрики.

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

Чистый бычий сигнал тональности за весь запрошенный период.

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

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

{
  "clusters": [
    {
      "activity_change_pct": 18.4,
      "bearish_posts": 438,
      "bullish_posts": 1120,
      "cluster_id": "smart_money",
      "neutral_posts": 284,
      "previous_total_posts": 1556,
      "recent_sentiment_signal": 84.2,
      "series": [
        {
          "bearish_posts": 438,
          "bullish_posts": 1120,
          "sentiment_signal": 128.6,
          "timestamp": "2026-08-07T15:00:00Z",
          "total_posts": 1842
        }
      ],
      "total_posts": 1842,
      "window_sentiment_signal": 63.7
    }
  ],
  "hours": 168
}