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

Распределение эмоций

GET /emotions
GetEmotions

Какие из 15 эмоций преобладают в разговоре об активе или субъекте со временем. proportion — доля каждой эмоции среди эмоций бакета (в сумме они дают 1); post_count считает посты, в которых она проявляется. Один пост может проявлять несколько.

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

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

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

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

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

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

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

Количество бакетов без подходящих данных.

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

Размер временного бакета, использованный в возвращённой серии.

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

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

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

Последний бакет UTC без подходящих данных.

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

Наблюдения эмоций с ключом по обнаруженной метке эмоции.

Допустимые ключи
angeranticipationboredomconfidencedisgustdistrustfeargreedjoyloveoptimismpessimismsadnesssurprisetrust
series.{key}[].post_count
integer (int64) обязательный

Необработанное количество постов с этой эмоцией в бакете.

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

Доля этой эмоции среди всех тегов эмоций в бакете, от 0 до 1.

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

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

{
  "series": {
    "optimism": [
      {
        "post_count": 286,
        "proportion": 0.37,
        "timestamp": "2026-08-07T15:00:00Z"
      }
    ]
  }
}