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

Позиции кластеров

GET /clusters/stances
GetClusterStances

Позиция одного кластера по его самым обсуждаемым активам рядом с позицией рынка, от −1 (полностью медвежья) до +1 (полностью бычья). contrarian_share — как часто он склоняется в сторону, противоположную рынку, со средним значением по другим кластерам для сравнения.

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

  • Отправьте cluster_id.
  • cluster_id указывает один кластер; чтобы сравнить несколько, вызывайте метод по одному разу на кластер или используйте /clusters, чтобы получить все кластеры сразу.
  • Сообщества авторов постов (wallstreetbets, reddit) охватывают только акции: при использовании одного из них asset_class должен включать equity.

Оплата кошельком доступна на https://nebula-api.hiddensystems.ai/api/v1/x402/clusters/stances. Аккаунт Nebula или API-ключ не требуются; проверьте предложение об оплате перед подписанием. Руководство по оплате x402.

Параметры

cluster_id string QUERY обязательный

Кластер для анализа в том виде, в каком его возвращает /clusters, например smart_money или wallstreetbets. Любой id из параметра clusters метода /sentiment.

Example:smart_money

asset_class array<string> QUERY

Рынки для анализа: любой из equity, commodity, index и crypto, через запятую. По умолчанию — все четыре. Можно передать несколько через запятую.

Default:equity,commodity,index,crypto

days integer QUERY

За сколько полных дней UTC измерять позиции, отсчитывая назад от последнего полного дня: 7, 30 или 90. Бесплатные тарифы охватывают 90 дней; при большем значении возвращается 403.

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

Default:30

limit integer QUERY

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

Default:30

Пример cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/stances' \
  --data-urlencode 'cluster_id=smart_money' \
  --header 'X-API-Key: YOUR_API_KEY'

Ответы

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

Тип медиа application/json

asset_classes
array<string> обязательный

Проанализированные рынки в порядке equity, commodity, index, crypto: запрошенные значения asset_class или все четыре, если asset_class был опущен.

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

Самые обсуждаемые подходящие активы кластера (3 или более постов кластера, 20 или более постов рынка), до limit.
assets[].asset_class
string обязательный

Класс актива: equity (акции и ETF), commodity, index или crypto. Передавайте его вместе с asset_id в каждом запросе, ограниченном активом.

Допустимые значения
equitycommodityindexcrypto
assets[].asset_id
string обязательный

Канонический публичный идентификатор актива: тикер или рыночный символ для акций, товаров и индексов, а для криптовалют — слаг CoinGecko (или, при его отсутствии, числовой id).

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

Посты кластера об активе за окно.

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

Чистая позиция кластера по активу за окно: (бычьи − медвежьи) / (бычьи + медвежьи) посты, от −1 (полностью медвежья) до +1 (полностью бычья).

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

Чистая позиция рынка по тому же активу за то же окно, по той же шкале от −1 до +1, по всем авторам, кроме ботов.

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

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

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

Отображаемый тикер или рыночный символ.

cluster_id
string обязательный

Проанализированный кластер в виде его канонического cluster_id.

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

Доля подходящих активов, по которым кластер и рынок склоняются в противоположные стороны, причём оба минимум на 0.1 от нейтральной позиции. Null при менее чем 5 активах.

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

Длина окна в полных днях UTC, заканчивающегося последним полным днём.

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

contrarian_share, усреднённый по остальным кластерам; null, если ни у одного из них его нет.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "assets": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "cluster_posts": 214,
      "cluster_stance": 0.62,
      "market_stance": 0.41,
      "name": "NVIDIA Corporation",
      "symbol": "NVDA"
    },
    {
      "asset_class": "equity",
      "asset_id": "TSLA",
      "cluster_posts": 137,
      "cluster_stance": -0.35,
      "market_stance": 0.22,
      "name": "Tesla, Inc.",
      "symbol": "TSLA"
    },
    {
      "asset_class": "equity",
      "asset_id": "AMZN",
      "cluster_posts": 96,
      "cluster_stance": 0.48,
      "market_stance": 0.3,
      "name": "Amazon.com, Inc.",
      "symbol": "AMZN"
    }
  ],
  "cluster_id": "smart_money",
  "contrarian_share": 0.1875,
  "days": 30,
  "peer_average_contrarian_share": 0.1123
}