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

Аналитика

GET /insights
ListInsights

Короткие заметки о том, что происходит на рынках — глобально или по одному активу или субъекту, — каждая с заголовком, сводкой, тональностью (−1, 0 или +1), тегами, важностью от 1 до 3 и связанными сущностями. Сначала недавно обновлённые; отправьте order_by=start_time_desc, чтобы сначала шли самые новые события.

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

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

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

limit integer QUERY

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

Default:10

offset integer QUERY

Количество пропущенных результатов.

Default:0

start_time_after string (date-time) QUERY

Только элементы, начинающиеся после этого времени в формате RFC3339. Бесплатные тарифы охватывают 90 дней; более ранние данные возвращают 403.

Example:2026-08-01T00:00:00Z

start_time_before string (date-time) QUERY

Только элементы, начинающиеся до этого времени в формате RFC3339. Бесплатные тарифы охватывают 90 дней; более ранние данные возвращают 403.

Example:2026-08-07T00:00:00Z

tags array<string> QUERY

Оставить заметки с любым из этих тегов, совпадение точное (например, earnings). Теги — это свободные метки; смотрите их в возвращённых заметках. Отправьте несколько через запятую.

Example:earnings

exclude_tags array<string> QUERY

Исключить заметки с любым из этих тегов. Совпадение идёт только по тегам, а не по категориям или доменам: чтобы исключить криптовалютные заметки, фильтруйте по доменам. Отправьте несколько через запятую.

Example:rumour

categories array<string> QUERY

Оставить заметки, основная категория которых входит в этот список, совпадение точное (например, equities или technology). Категории свободные; смотрите их в возвращённых заметках. Отправьте несколько через запятую.

Example:equities

domains array<string> QUERY

Оставить заметки в любом из этих доменов. Отправьте несколько через запятую.

Example:equities,macro

order_by string QUERY

Порядок результатов. По умолчанию updated_at_desc.

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

Default:updated_at_desc

Пример cURL

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/insights' \
  --header 'X-API-Key: YOUR_API_KEY'

Ответы

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

Тип медиа application/json

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

Отобранные аналитические материалы, соответствующие заданным фильтрам.
insights[].category
string необязательный

Основная категория аналитики, если она назначена.

insights[].domains
array<string> обязательный

Рыночные домены или домены субъектов, привязанные к записи.

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

Активы и субъекты, не являющиеся активами, связанные с этой записью.
insights[].entities[].asset_class
string необязательный

Класс актива, отправляется вместе с asset_id.

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

Для акции, сырья, индекса или монеты — это asset_id, который принимают эндпоинты активов; отсутствует для людей, аккаунтов и тем, а также для редкого актива, который Nebula не может определить.

insights[].entities[].entity_id
string обязательный

Идентификатор Nebula для связанной сущности, например eq:NVDA, gecko:1 или text:ai. Чтобы запросить сущность, используйте asset_id и asset_class или subject_id из того же объекта.

insights[].entities[].entity_types
array<string> обязательный

Классификации графа знаний для связанной сущности.

insights[].entities[].is_direct
boolean обязательный

True, если запись напрямую касается этой связанной сущности.

insights[].entities[].is_primary
boolean обязательный

True, если это основная связанная сущность записи.

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

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

insights[].entities[].role
string обязательный

Связь связанной сущности с аналитическим материалом.

insights[].entities[].subject_id
string необязательный

Для человека, аккаунта или темы — это subject_id, который принимают эндпоинты, работающие с субъектами; отсутствует для активов.

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

Краткий аналитический заголовок.

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

Важность от 1 (низкая) до 3 (высокая).

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

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

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

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

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

Время в UTC, когда начинается аналитический материал или событие.

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

Обоснованное фактами резюме элемента аналитики.

insights[].tags
array<string> обязательный

Метки для поиска, привязанные к записи.

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

Время последнего обновления записи в UTC.

{
  "insights": [
    {
      "category": "earnings",
      "domains": [
        "equities",
        "technology"
      ],
      "entities": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "entity_id": "eq:NVDA",
          "entity_types": [
            "equity"
          ],
          "is_direct": true,
          "is_primary": true,
          "name": "NVIDIA Corporation",
          "role": "primary",
          "subject_id": "text:jensen huang"
        }
      ],
      "headline": "NVIDIA raises its quarterly revenue outlook",
      "importance_score": 3,
      "insight_id": 38421,
      "sentiment_score": 1,
      "start_time": "2026-08-20T20:00:00Z",
      "summary": "Management raised guidance after stronger-than-expected data-centre demand.",
      "tags": [
        "earnings",
        "data_centres"
      ],
      "updated_at": "2026-08-07T14:35:00Z"
    }
  ]
}