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

События календаря

GET /calendar-events
ListCalendarEvents

Предстоящие и прошедшие рыночные события (отчётность, публикация экономических данных, IPO, листинги, голосования, слушания) — глобальные или по одному активу либо субъекту, с типом, статусом, важностью от 1 до 3 и участвующими сущностями. По умолчанию — с сегодняшнего дня и далее, сначала самые ранние; отправьте min_importance_score=2 для значимых событий.

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

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

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

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

domains array<string> QUERY

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

Example:equities,macro

event_types array<string> QUERY

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

Example:earnings,economic_release

statuses array<string> QUERY

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

Example:scheduled,postponed

min_importance_score integer QUERY

Минимальная важность от 1 (низкая) до 3 (высокая). По умолчанию 1, что включает все события.

Default:1

Пример cURL

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

Ответы

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

Тип медиа application/json

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

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

Стабильный публичный идентификатор события календаря.

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

Уверенность в событии от 1 (низкая) до 10 (высокая).

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

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

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

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

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

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

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

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

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

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

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

calendar_events[].entities[].confidence
number (float) необязательный

Уверенность в связи с сущностью, когда доступна.

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

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

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

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

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

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

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

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

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

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

calendar_events[].event_metadata
object необязательный

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

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

Более точная классификация события, когда доступна.

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

Классификация события верхнего уровня.

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

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

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

Место физического проведения события, когда оно известно. Отсутствует для онлайн- и on-chain-событий.

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

Оценка долгосрочного влияния на рынок от 1 (низкое) до 3 (высокое).

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

Оценка макроэкономического влияния от 1 (низкое) до 3 (высокое).

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

Оценка прямого влияния на цену от 1 (низкое) до 3 (высокое).

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

Оценка краткосрочного влияния на рынок от 1 (низкое) до 3 (высокое).

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

Количество источников, подтверждающих событие.

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

Записи источников, подтверждающие родительский ответ.
calendar_events[].sources[].external_id
string обязательный

Идентификатор, присвоенный внешним источником.

calendar_events[].sources[].provider
string необязательный

Вышестоящий поставщик данных, когда доступен.

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

Время публикации в UTC.

calendar_events[].sources[].publisher
string необязательный

Исходный издатель, когда доступен.

calendar_events[].sources[].source
string обязательный

Платформа или лента источника.

calendar_events[].sources[].subtype
string обязательный

Подтип источника.

calendar_events[].sources[].trusted
boolean обязательный

Относится ли источник к доверенным.

calendar_events[].sources[].url
string необязательный

Публичный URL источника, когда доступен.

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

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

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

Текущий статус жизненного цикла события: scheduled, tentative, cancelled или postponed.

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

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

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

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

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

Оценка влияния хвостового риска от 1 (низкое) до 3 (высокое).

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

Точность публикуемого времени события: минута, час, день, неделя, месяц, год или неизвестно. Событие с точностью до дня начинается в 00:00 UTC этого дня.

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

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

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

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

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

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

{
  "calendar_events": [
    {
      "calendar_event_id": "earnings:nvda:2026-q3",
      "confidence_score": 9,
      "created_at": "2026-08-06T10:00:00Z",
      "domains": [
        "equities",
        "technology"
      ],
      "end_time": "2026-08-20T21:00:00Z",
      "entities": [
        {
          "asset_class": "equity",
          "asset_id": "NVDA",
          "confidence": 0.98,
          "entity_id": "eq:NVDA",
          "is_primary": true,
          "name": "NVIDIA Corporation",
          "role": "affected",
          "subject_id": "text:jensen huang"
        }
      ],
      "event_metadata": {
        "fiscal_quarter": "Q3",
        "fiscal_year": 2026
      },
      "event_subtype": "quarterly_results",
      "event_type": "earnings",
      "importance_score": 3,
      "location": "Santa Clara, California",
      "long_term_impact_score": 2,
      "macro_impact_score": 1,
      "price_impact_score": 3,
      "short_term_impact_score": 3,
      "source_count": 4,
      "sources": [
        {
          "external_id": "0001045810-26-000123",
          "provider": "SEC EDGAR",
          "published_at": "2026-08-07T14:30:00Z",
          "publisher": "NVIDIA Corporation",
          "source": "sec",
          "subtype": "filing",
          "trusted": true,
          "url": "https://www.sec.gov/Archives/edgar/data/1045810/example.htm"
        }
      ],
      "start_time": "2026-08-20T20:00:00Z",
      "status": "scheduled",
      "summary": "Management raised guidance after stronger-than-expected data-centre demand.",
      "tags": [
        "earnings",
        "data_centres"
      ],
      "tail_risk_impact_score": 1,
      "time_precision": "exact",
      "title": "NVIDIA Q3 2026 earnings",
      "trusted_source_count": 3,
      "updated_at": "2026-08-07T14:35:00Z"
    }
  ]
}