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

Настроения

GET /sentiment
GetSentiment

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

cohorts даёт ту же метрику для ботов и, для одного актива или темы, для top callers. Отправьте 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/sentiment. Аккаунт 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=kols&clusters=media. Выбранные кластеры складываются, и автор может принадлежать к нескольким.

  • Callers: smart_money (лучшие по результатам), dumb_money (худшие по результатам), top_degens (лучшие в малой капитализации криптовалют)
  • Timing: early_movers (первыми говорят об активе по мере роста внимания), late_movers (приходят на пике или после)
  • Строители: developers, founders, team_leaders, project_accounts
  • Институты: vcs, asset_managers, dao_guild_funds, incubators, exchanges
  • Влияние: kols, celebrities, media, marketer, shiller
  • Аналитики: ta_analyst, fa_analyst, macro_analyst, onchain_analyst, investigators
  • Трейдеры: position_trader, swing_trader, day_trader
  • Смещение: perma_bull, doomer, tribalist
  • Другое: political, nft, bots, automated_ai
  • Сообщества по месту публикации поста: wallstreetbets, reddit

Example:smart_money

Пример cURL

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

Ответы

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

Тип медиа application/json

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

Та же метрика для других групп авторов: bots и top_callers, когда эта совокупность доступна. Совокупность не-ботов — это сам series.

Допустимые ключи
botstop_callers
cohorts.{key}[].bearish_posts
number (double) обязательный

Медвежьи посты за последние 24 часа, заканчивающиеся в этой точке; interval_bearish_posts — это посты данного интервала.

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

Бычьи посты за последние 24 часа, заканчивающиеся в этой точке; interval_bullish_posts — это посты данного интервала.

cohorts.{key}[].interval_bearish_posts
number (double) необязательный

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

cohorts.{key}[].interval_bullish_posts
number (double) необязательный

Бычьи посты в этом выданном временном интервале.

cohorts.{key}[].interval_neutral_posts
number (double) необязательный

Нейтральные посты в этом выданном временном интервале.

cohorts.{key}[].interval_posts
number (double) необязательный

Посты в этом выданном временном интервале до накопления за окно ретроспективы.

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

Нейтральные посты за последние 24 часа, заканчивающиеся в этой точке; interval_neutral_posts — это посты данного интервала.

cohorts.{key}[].sentiment_signal
number (double) обязательный

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

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

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

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

Посты за последние 24 часа, заканчивающиеся в этой точке, а не только в этом интервале; interval_posts — это посты данного интервала.

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

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

Медвежьи посты за последние 24 часа, заканчивающиеся в этой точке; interval_bearish_posts — это посты данного интервала.

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

Бычьи посты за последние 24 часа, заканчивающиеся в этой точке; interval_bullish_posts — это посты данного интервала.

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

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

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

Бычьи посты в этом выданном временном интервале.

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

Нейтральные посты в этом выданном временном интервале.

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

Посты в этом выданном временном интервале до накопления за окно ретроспективы.

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

Нейтральные посты за последние 24 часа, заканчивающиеся в этой точке; interval_neutral_posts — это посты данного интервала.

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

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

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

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

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

Посты за последние 24 часа, заканчивающиеся в этой точке, а не только в этом интервале; interval_posts — это посты данного интервала.

{
  "cohorts": {
    "bots": [
      {
        "bearish_posts": 438,
        "bullish_posts": 1120,
        "neutral_posts": 284,
        "sentiment_signal": 128.6,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 1842
      }
    ]
  },
  "series": [
    {
      "bearish_posts": 438,
      "bullish_posts": 1120,
      "interval_bearish_posts": 18,
      "interval_bullish_posts": 46,
      "interval_neutral_posts": 10,
      "interval_posts": 74,
      "neutral_posts": 284,
      "sentiment_signal": 128.6,
      "timestamp": "2026-08-07T15:00:00Z",
      "total_posts": 1842
    }
  ]
}