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

REST API
Аналитика

Внимание к инсайтам

GET /insights/attention

GetInsightAttention

Обсуждение вокруг одной единицы аналитики: 24-часовое окно внимания, количество авторов и распределение тональности, почасовые интервалы, состав кластеров, векторы влияния и ценовые реакции для каждой связанной сущности с ценой. Используйте после /insights, когда читатель открывает одну единицу и ему нужен полный контекст уровня панели.

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

Параметры

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

Стабильный идентификатор единицы аналитики, возвращаемый /insights. Бесплатные тарифы охватывают 90 дней назад; при более раннем запросе возвращается 403.

Example:1

Пример cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/insights/attention' \
  --data-urlencode 'insight_id=1' \
  --header 'X-API-Key: YOUR_API_KEY'

Ответы

200 OK

400 Некорректный запрос

401 Не авторизован

402 Кредиты израсходованы; ответ содержит срок продления и баланс купленных кредитов

403 Доступ запрещён

404 Не найдено

405 Метод не поддерживается; поддерживаемые методы перечислены в заголовке Allow

429 Слишком много запросов

500 Внутренняя ошибка сервера

503 Сервис недоступен

Тип медиа application/json

attention

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

Сводка обсуждения и влияния для запрошенной единицы аналитики.

attention.anchor_subject_id

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

Идентификатор субъекта, используемый для привязки сканирования внимания.

attention.authors

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

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

attention.average_sentiment_score

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

Среднее арифметическое оценок тональности постов по шкале от −100 (крайне по-медвежьи) до +100 (крайне по-бычьи).

attention.bearish_posts

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

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

attention.bucket_hours

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

Ширина каждого интервала в часах.

attention.buckets

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

Интервалы внимания в хронологическом порядке.

attention.buckets[].authors

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

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

attention.buckets[].average_sentiment_score

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

Среднее арифметическое оценок тональности постов по шкале от −100 (крайне по-медвежьи) до +100 (крайне по-бычьи).

attention.buckets[].bearish_posts

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

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

attention.buckets[].bullish_posts

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

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

attention.buckets[].neutral_posts

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

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

attention.buckets[].posts

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

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

attention.buckets[].timestamp

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

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

attention.bullish_posts

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

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

attention.cluster_mix

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

Состав кластеров авторов для подходящих публикаций, упорядоченный по числу авторов.

attention.cluster_mix[].authors

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

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

attention.cluster_mix[].cluster_id

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

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

attention.cluster_mix[].posts

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

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

attention.cluster_mix[].share

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

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

attention.clusters

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

Количество различных кластеров авторов, представленных подходящими публикациями.

attention.from

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

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

attention.impact

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

Структурированная оценка влияния для единицы аналитики.

attention.impact.max_score

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

Максимально возможная оценка для каждого вектора влияния.

attention.impact.sentiment_score

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

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

attention.impact.vectors

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

Векторы влияния, лежащие в основе оценки влияния на уровне единицы.

attention.impact.vectors[].key

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

Стабильный машиночитаемый ключ для этого вектора влияния.

attention.impact.vectors[].label

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

Понятная человеку метка интервала или индекса.

attention.impact.vectors[].score

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

Оценка для этого вектора влияния.

attention.last_post_at

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

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

attention.neutral_posts

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

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

attention.optional_subjects

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

Идентификаторы субъектов, хотя бы один из которых должны были упоминать подходящие публикации; пустое значение означает, что необязательная сторона не требовалась.

attention.posts

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

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

attention.required_subjects

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

Идентификаторы субъектов, которые должны были упоминать все подходящие публикации.

attention.subjects_used

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

Идентификаторы субъектов, фактически использованные для возвращённого окна внимания после всех откатов.

attention.to

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

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

attention.window_kind

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

Размещение окна относительно инсайта: до или вокруг.

insight_id

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

Стабильный идентификатор аналитического материала.

price_reactions

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

Ценовые реакции для сущностей с ценой, связанных с единицей аналитики.

price_reactions[].insight_at

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

Время UTC, используемое как базовая точка для ценовой реакции.

price_reactions[].insight_id

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

Стабильный идентификатор аналитического материала.

price_reactions[].live_pct

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

Последнее изменение цены относительно базовой точки инсайта; присутствует для недавних инсайтов.

price_reactions[].moves

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

Ценовые движения с фиксированным горизонтом после истечения каждого горизонта.

price_reactions[].moves[].change_pct

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

Изменение цены в процентных пунктах относительно базовой точки на момент инсайта.

price_reactions[].moves[].hours

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

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

price_reactions[].series

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

Наблюдения в хронологическом порядке.

price_reactions[].series[].change_pct

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

Изменение цены в процентных пунктах относительно базовой точки на момент инсайта.

price_reactions[].series[].timestamp

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

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

price_reactions[].subject_id

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

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

{
  "attention": {
    "anchor_subject_id": "eq:NVDA",
    "authors": 241,
    "average_sentiment_score": 38.5,
    "bearish_posts": 438,
    "bucket_hours": 1,
    "buckets": [
      {
        "authors": 241,
        "average_sentiment_score": 38.5,
        "bearish_posts": 438,
        "bullish_posts": 1120,
        "neutral_posts": 284,
        "posts": 684,
        "timestamp": "2026-08-07T15:00:00Z"
      }
    ],
    "bullish_posts": 1120,
    "cluster_mix": [
      {
        "authors": 241,
        "cluster_id": "smart_money",
        "posts": 684,
        "share": 0.148
      }
    ],
    "clusters": 4,
    "from": "2026-08-15T09:00:00Z",
    "last_post_at": "2026-08-22T08:45:00Z",
    "neutral_posts": 284,
    "optional_subjects": [
      "string"
    ],
    "posts": 684,
    "required_subjects": [
      "string"
    ],
    "subjects_used": [
      "string"
    ],
    "to": "2026-08-22T09:00:00Z",
    "window_kind": "around"
  },
  "insight_id": 38421,
  "price_reactions": [
    {
      "insight_at": "2026-08-20T20:00:00Z",
      "insight_id": 38421,
      "live_pct": 1.8,
      "moves": [
        {
          "change_pct": 2.4,
          "hours": 168
        }
      ],
      "series": [
        {
          "change_pct": 2.4,
          "timestamp": "2026-08-07T15:00:00Z"
        }
      ],
      "subject_id": "text:artificial intelligence"
    }
  ]
}