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

Социальный импульс

GET /social-momentum
GetSocialMomentum

Посты, уникальные авторы и тональность внутри каждого кластера авторов — рядом друг с другом, для актива, субъекта или целого рынка: какие группы движут беседой и чем отличается их тон. Кластеры пересекаются, поэтому не складывайте их. Передайте clusters, чтобы вернуть только названные вами.

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

  • asset_id необходимо отправлять вместе с asset_class.
  • subject_id нельзя комбинировать с asset_id или asset_class.
  • Без asset_id параметр asset_class должен быть equity или crypto; для commodity и index требуется asset_id.

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

Параметры

asset_id string QUERY

Asset ID из /assets или /search, например NVDA, GLD, SPX или bitcoin. Передавайте его вместе с возвращённым рядом с ним asset_class.

Example:NVDA

asset_class string QUERY

Вместе с asset_id — класс актива. Без него — рынок для агрегации: equity (акции, сырьевые товары и индексы; значение по умолчанию) или crypto.

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

Example:equity

subject_id string QUERY

Канонический идентификатор, не относящийся к активу, возвращаемый /subjects или /search, например text:jensen huang или handle:elonmusk. Принимается в любом регистре. Его нельзя комбинировать с asset_id или asset_class.

Example:text:jensen huang

hours integer QUERY

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

Default:168

granularity string QUERY

Запрашиваемый размер интервала временного ряда. Если не указан, сервис выбирает размер интервала, подходящий для окна ретроспективы.

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

Example:1h

clusters array<string> QUERY

Только эти кластеры, каждый как отдельный ряд; опустите для всех. Использует идентификаторы из параметра clusters эндпоинта /sentiment, кроме сообществ публикующих.

Example:smart_money

Пример cURL

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

Ответы

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

Тип медиа application/json

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

Ряд социальной динамики с ключами по каноническому идентификатору кластера авторов.
clusters.{key}[].average_sentiment_score
number (double) обязательный

Среднее арифметическое оценок тональности постов по шкале от −100 (крайне по-медвежьи) до +100 (крайне по-бычьи).

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

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

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

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

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

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

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

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

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

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

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

Уникальные публикующие аккаунты в интервале; при гранулярности грубее часовой это верхняя граница, полученная суммированием почасовых значений.

{
  "clusters": {
    "smart_money": [
      {
        "average_sentiment_score": 38.5,
        "bearish_posts": 41,
        "bullish_posts": 112,
        "neutral_posts": 31,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 184,
        "unique_posters": 73
      }
    ]
  }
}