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

Сентимент по таймфреймам

GET /sentiment/timeframes
GetSentimentTimeframes

Тональность в разбивке по горизонту, о котором говорят люди: краткосрочный (до недели), среднесрочный (от недель до месяцев) и долгосрочный (три месяца и более), каждый по шкале /sentiment. Отделяет толпу, которая настроена по-медвежьи на этой неделе, но по-бычьи на год, от той, что настроена по-медвежьи на всём горизонте.

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

  • Отправьте asset_id или subject_id.
  • asset_id необходимо отправлять вместе с asset_class.
  • subject_id нельзя комбинировать с asset_id или asset_class.

Оплата кошельком доступна на https://nebula-api.hiddensystems.ai/api/v1/x402/sentiment/timeframes. Аккаунт 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 (акции и ETF), commodity, index или crypto. Передавайте asset_class, который /assets или /search вернули вместе с asset_id.

Допустимые значения
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:720

granularity string QUERY

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

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

Example:1h

Пример cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/sentiment/timeframes' \
  --data-urlencode 'asset_id=NVDA' \
  --data-urlencode 'asset_class=equity' \
  --header 'X-API-Key: YOUR_API_KEY'

Ответы

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

Тип медиа application/json

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

Последнее значение тональности для каждого доступного временного горизонта.

Допустимые ключи
short_termmedium_termlong_term
metadata
object необязательный

Метаданные методологии и окна запроса, необходимые для интерпретации ответа.
metadata.as_of
string (date-time) необязательный

Время в UTC, на которое была рассчитана метрика.

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

Краткое название метода расчёта.

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

Формула расчёта в удобочитаемом виде.

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

Несмотря на название, это длина окна линейного затухания в часах: пост учитывается полностью, когда он новый, наполовину — в середине окна, и не учитывается вовсе, когда он достигает этого возраста.

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

Историческая глубина, используемая расчётом, в днях.

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

Опубликованная шкала или интерпретация метрики.

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

Ряд тональности с ключами short_term, medium_term и long_term по горизонтам.

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

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

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

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

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

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

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

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

{
  "current": {
    "long_term": 52.1,
    "medium_term": 57.8,
    "short_term": 64.2
  },
  "series": {
    "short_term": [
      {
        "sentiment_signal": 64.2,
        "timestamp": "2026-08-07T15:00:00Z",
        "total_posts": 318
      }
    ]
  }
}