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

Пересечение кластеров

GET /clusters/overlap
GetClusterOverlap

Какие кластеры следят за теми же активами, что и этот, и совпадают ли они во мнениях. overlap_share — какую долю из своих топ-50 активов разделяет другой кластер; direction_agreement_share — как часто они придерживаются одного направления; stance_gap положительно, когда этот кластер настроен более бычье.

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

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

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

Пример cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/overlap' \
  --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 был опущен.

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

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

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

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

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

Все остальные активные кластеры, начиная с наиболее пересекающихся.
peers[].agreeing_asset_count
integer обязательный

Сравниваемые активы, по которым оба кластера придерживаются одного направления относительно рынка.

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

Канонический идентификатор кластера авторов.

peers[].compared_asset_count
integer обязательный

Общие активы по всему пересечению, по которым оба кластера отклоняются от позиции рынка как минимум на 0.05.

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

По общим активам, где оба кластера отклоняются от позиции рынка как минимум на 0.05, доля тех, по которым они придерживаются одного направления: agreeing_asset_count ÷ compared_asset_count. Null при менее чем 3 активах.

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

Доля набора фокуса этого кластера, которая также входит в набор другого кластера, от 0 до 1.

peers[].shared_assets
array<object> обязательный

До 5 активов, входящих в оба набора фокуса, в порядке внимания этого кластера.
peers[].shared_assets[].asset_class
string обязательный

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

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

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

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

Чистая позиция этого кластера по активу, от −1 до +1. Null при менее чем 3 бычьих или медвежьих постах.

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

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

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

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

peers[].shared_assets[].peer_stance
number (double) обязательный

Чистая позиция другого кластера по активу, от −1 до +1. Null при менее чем 3 бычьих или медвежьих постах.

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

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

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

Позиция этого кластера минус позиция другого кластера, усреднённая по общим активам, по которым у обоих есть позиция, от −2 до +2. Положительное значение означает, что этот кластер настроен более бычье. Null при менее чем 3 активах.

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

Размер набора фокуса каждого кластера: его наиболее обсуждаемые активы, не более указанного количества.

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "cluster_id": "smart_money",
  "days": 30,
  "peers": [
    {
      "agreeing_asset_count": 11,
      "cluster_id": "fa_analyst",
      "compared_asset_count": 17,
      "direction_agreement_share": 0.6471,
      "overlap_share": 0.62,
      "shared_assets": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "cluster_stance": 0.62,
          "market_stance": 0.41,
          "name": "NVIDIA Corporation",
          "peer_stance": 0.54,
          "symbol": "NVDA"
        },
        {
          "asset_class": "equity",
          "asset_id": "AMZN",
          "cluster_stance": 0.48,
          "market_stance": 0.3,
          "name": "Amazon.com, Inc.",
          "peer_stance": null,
          "symbol": "AMZN"
        }
      ],
      "stance_gap": 0.0812
    },
    {
      "agreeing_asset_count": 5,
      "cluster_id": "kols",
      "compared_asset_count": 12,
      "direction_agreement_share": 0.4167,
      "overlap_share": 0.46,
      "shared_assets": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "cluster_stance": 0.62,
          "market_stance": 0.41,
          "name": "NVIDIA Corporation",
          "peer_stance": 0.71,
          "symbol": "NVDA"
        },
        {
          "asset_class": "equity",
          "asset_id": "TSLA",
          "cluster_stance": -0.35,
          "market_stance": 0.22,
          "name": "Tesla, Inc.",
          "peer_stance": 0.28,
          "symbol": "TSLA"
        }
      ],
      "stance_gap": -0.1375
    }
  ],
  "top_asset_count": 50
}