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

Прогнозные рынки

GET /predictions
ListPredictionMarkets

Просматривайте контракты Polymarket и Kalshi. Цены — это вероятности исходов на каждой площадке, а не социальный сентимент. Объём сохраняет единицы измерения площадки. Эквивалентные контракты объединяются в один рынок; связанные контракты остаются отдельными. Метрики субъектов используют существующие эндпоинты subject и asset.

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

Параметры

query string QUERY

Поиск без учёта регистра по публичным идентификаторам и названиям.

Example:NVIDIA

provider string QUERY

Площадка (необязательно)

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

Example:polymarket

status string QUERY

По умолчанию — open

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

Default:open

subject_id string QUERY

Канонический идентификатор, не относящийся к активу, возвращаемый /subjects или /search, например text:jensen huang или handle:elonmusk. Принимается в любом регистре. Его нельзя комбинировать с asset_id или asset_class.

Example:text:jensen huang

limit integer QUERY

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

Default:25

offset integer QUERY

Смещение пагинации

Default:0

Пример cURL

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

Ответы

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

Тип медиа application/json

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

True, когда после возвращённых записей доступна следующая страница.

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

Максимальное запрошенное количество записей.

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

Канонические рынки, упорядоченные по лучшему рангу активности внутри каждой площадки. Объёмы площадок не суммируются.
markets[].id
string обязательный

Стабильный идентификатор в рамках этого типа объекта.

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

Листинги площадок с отдельно сохраняемыми правилами и котировками.
markets[].listings[].closes_at
string (date-time) обязательный

Время закрытия торгов на площадке в UTC; не обязательно совпадает с наступлением события или расчётом.

markets[].listings[].event_id
string обязательный

Идентификатор события на площадке, или пусто, если отсутствует.

markets[].listings[].id
string обязательный

Стабильный идентификатор в рамках этого типа объекта.

markets[].listings[].liquidity_usd
number (double) обязательный

Ликвидность на площадке в долларах США; null, если недоступна.

markets[].listings[].market_id
string обязательный

Канонический идентификатор рынка; эквивалентные листинги площадок разделяют его.

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

Время UTC, когда Nebula получила эту котировку. Проверяйте свежесть перед сравнением.

markets[].listings[].open_interest
number (double) обязательный

Открытые контракты на площадке; null, если недоступны.

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

Время открытия площадки в UTC; null, если недоступно.

markets[].listings[].outcomes
array<object> обязательный

Упорядоченные нативные исходы с независимыми ценовыми свидетельствами.

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

Площадка: polymarket или kalshi.

markets[].listings[].provider_id
string обязательный

Нативный идентификатор рынка на площадке.

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

Время обновления метаданных площадки; null, если недоступно.

markets[].listings[].question
string обязательный

Исходный вопрос контракта.

markets[].listings[].resolution_source
string обязательный

Источник расчёта на площадке, или пусто, если отсутствует.

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

Ожидаемое время расчёта на площадке в UTC; null, если недоступно.

markets[].listings[].result
string обязательный

Результат расчёта на площадке; пусто до известного результата.

markets[].listings[].revision
string обязательный

SHA-256 от вопроса, правил, источника, времени закрытия и ориентации исходов.

markets[].listings[].rules
string обязательный

Полные правила расчёта на площадке.

markets[].listings[].source_url
string обязательный

Исходный URL листинга на площадке.

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

Жизненный цикл листинга: open, closed, resolved или disputed. Для субъектов: resolved или pending.

markets[].listings[].volume
number (double) обязательный

Совокупный объём площадки в volume_unit; null, если недоступен.

markets[].listings[].volume_24h
number (double) обязательный

Объём площадки за последние 24 часа в volume_unit; null, если недоступен.

markets[].listings[].volume_unit
string обязательный

usd для Polymarket, contracts для Kalshi. Эти величины нельзя складывать.

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

Исходный вопрос контракта.

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

Связанные субъекты. Используйте их существующие аналитические эндпоинты отдельно; рыночные настроения не выводятся.
markets[].subjects[].fallback_image_urls
array<string> обязательный

Упорядоченные кандидаты иконок-запасных вариантов, определённые бэкендом.

markets[].subjects[].image_url
string обязательный

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

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

Каноническое отображаемое имя субъекта.

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

Роль привязки вопроса: entity, topic или place.

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

Жизненный цикл листинга: open, closed, resolved или disputed. Для субъектов: resolved или pending.

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

Канонический идентификатор субъекта из реестра; сохраняет существующую пригодность актива или темы.

markets[].subjects[].types
array<string> обязательный

Канонические типы субъектов из существующего резолвера идентичности.

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

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

{
  "has_more": false,
  "limit": 50,
  "markets": [
    {
      "id": "polymarket:123",
      "listings": [
        {
          "closes_at": "2026-10-07T20:00:00Z",
          "event_id": "event-123",
          "id": "polymarket:123",
          "liquidity_usd": 5000,
          "market_id": "polymarket:123",
          "observed_at": "2026-10-06T12:00:00Z",
          "open_interest": 100,
          "opens_at": "2026-10-01T00:00:00Z",
          "outcomes": [],
          "provider": "polymarket",
          "provider_id": "123",
          "provider_updated_at": "2026-10-06T12:00:00Z",
          "question": "Will NVIDIA close above $200 on October 7?",
          "resolution_source": "Official exchange close",
          "resolves_at": "2026-10-08T00:00:00Z",
          "result": "yes",
          "revision": "revision-hash",
          "rules": "Resolves Yes if the official closing price exceeds $200.",
          "source_url": "https://polymarket.com/event/example",
          "status": "open",
          "volume": 10000,
          "volume_24h": 1000,
          "volume_unit": "usd"
        }
      ],
      "question": "Will NVIDIA close above $200 on October 7?",
      "subjects": [
        {
          "fallback_image_urls": [],
          "image_url": "https://example.com/nvda.png",
          "name": "NVIDIA",
          "role": "entity",
          "status": "open",
          "subject_id": "eq:NVDA",
          "types": []
        }
      ]
    }
  ],
  "offset": 0
}