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

Связанные субъекты

GET /related-subjects
GetRelatedSubjects

Люди, аккаунты и темы, которые чаще всего обсуждаются в тех же постах, что и актив или субъект. share — это общие посты как доля от постов якоря; поля тональности отражают тональность якоря в этих общих постах.

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

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

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

limit integer QUERY

Максимальное число возвращаемых результатов.

Default:25

Пример cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/related-subjects' \
  --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

authors
integer (int64) обязательный

Уникальные авторы, представленные совпадающими постами.

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

Средняя оценка тональности по всем постам якоря в запрошенном окне.

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

Включающее начало измеряемого окна в UTC.

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

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

posts
integer (int64) обязательный

Количество совпадающих постов за запрошенное окно.

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

Субъекты, не являющиеся активами, возвращаемые операцией discovery.
subjects[].authors
integer (int64) обязательный

Уникальные авторы, представленные совпадающими постами.

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

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

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

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

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

Время в UTC первого совпадающего поста в запрошенном окне.

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

Время в UTC последнего совпадающего поста в запрошенном окне.

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

Понятное человеку название.

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

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

subjects[].posts
integer (int64) обязательный

Количество совпадающих постов за запрошенное окно.

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

Относительное изменение от posts_prior к posts_recent; положительные значения указывают на рост.

subjects[].posts_prior
integer (int64) обязательный

Совпадающие посты в первой половине запрошенного окна.

subjects[].posts_recent
integer (int64) обязательный

Совпадающие посты во второй половине запрошенного окна.

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

Разница между sentiment_score для общей беседы и средним значением якоря за всё окно.

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

Знаковая оценка тональности; положительная — бычья, отрицательная — медвежья.

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

Посты якоря, в которых также упоминается этот субъект, как десятичная доля от всех постов якоря в окне.

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

Канонический идентификатор для не связанных с активами человека, аккаунта или темы.

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

Исключающее окончание измеряемого окна в UTC.

{
  "authors": 241,
  "average_sentiment_score": 36.2,
  "from": "2026-08-15T09:00:00Z",
  "hours": 168,
  "posts": 684,
  "subjects": [
    {
      "authors": 73,
      "bearish_posts": 41,
      "bullish_posts": 112,
      "first_post_at": "2026-08-15T09:00:00Z",
      "last_post_at": "2026-08-22T08:45:00Z",
      "name": "Artificial Intelligence",
      "neutral_posts": 31,
      "posts": 184,
      "posts_delta": 0.556,
      "posts_prior": 72,
      "posts_recent": 112,
      "sentiment_delta": 8.4,
      "sentiment_score": 42.6,
      "share": 0.148,
      "subject_id": "text:artificial intelligence"
    }
  ],
  "to": "2026-08-22T09:00:00Z"
}