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

Доля внимания

GET /mindshare
GetMindshare

Доля актива или субъекта в обсуждении: его посты за последние 24 часа как часть всех постов на его рынке (акции, криптовалюты или люди и темы), от 0 до 1. Отправьте clusters, чтобы измерить долю внутри одной или нескольких групп авторов.

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

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

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

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

Example:smart_money

Пример cURL

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

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

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

Доля доступного социального внимания в виде десятичной дроби от 0 до 1.

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

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

{
  "series": [
    {
      "share": 0.148,
      "timestamp": "2026-08-07T15:00:00Z"
    }
  ]
}