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

Спорные активы

GET /clusters/comparison/divisive-assets
GetDivisiveAssets

Широко обсуждаемые активы, по которым кластеры расходятся сильнее всего. minority_share — доля меньшего лагеря среди кластеров, явно склоняющихся к бычьей или медвежьей позиции, так что 0.5 — это равный раскол. Показатель измеряет разделённость обсуждения, а не грядущее движение.

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

Параметры

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:10

Пример cURL

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/clusters/comparison/divisive-assets' \
  --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> обязательный

Спорные активы, начиная с наиболее равномерно разделённых, до limit.
assets[].asset_class
string обязательный

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

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

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

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

Кластеры с медвежьей позицией по активу на 0.1 или больше.

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

Кластеры с бычьей позицией по активу на 0.1 или больше.

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

Каждый кластер с позицией по активу (8 или больше бычьих или медвежьих постов), начиная с самого медвежьего.
assets[].cluster_stances[].cluster_id
string обязательный

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

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

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

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

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

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

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

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

Доля меньшей стороны среди кластеров, явно склоняющихся к бычьей или медвежьей позиции (0.1 или больше в любую сторону), от 0 (все в одну сторону) до 0.5 (равный раскол). По ней ранжируются активы.

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

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

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

Межквартильный размах позиций кластеров, от 0 до 2: насколько далеко друг от друга находится средняя половина кластеров. Разрешает ничьи в minority_share.

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

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

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

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

{
  "asset_classes": [
    "equity",
    "commodity",
    "index",
    "crypto"
  ],
  "assets": [
    {
      "asset_class": "equity",
      "asset_id": "WMT",
      "bearish_cluster_count": 14,
      "bullish_cluster_count": 5,
      "cluster_stances": [
        {
          "cluster_id": "policy_political",
          "posts": 64,
          "stance": -0.58
        },
        {
          "cluster_id": "media",
          "posts": 311,
          "stance": -0.21
        },
        {
          "cluster_id": "automated_ai",
          "posts": 28,
          "stance": 0.75
        }
      ],
      "market_stance": -0.17,
      "minority_share": 0.2632,
      "name": "Walmart Inc.",
      "stance_iqr": 0.6125,
      "symbol": "WMT"
    }
  ],
  "days": 30
}