Детали прогнозного рынка

GET /predictions/market
GetPredictionMarket

Правила контракта, исходы, наблюдения площадок и связанные субъекты. Ожидающие субъекты ждут существующий резолвер. Комбинированные рыночные настроения не выводятся.

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

Параметры

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

Стабильный идентификатор рынка или листинга из /predictions

Example:polymarket:123

Пример cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/predictions/market' \
  --data-urlencode 'market_id=polymarket:123' \
  --header 'X-API-Key: YOUR_API_KEY'

Ответы

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

Тип медиа application/json

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

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

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

Листинги площадок с отдельно сохраняемыми правилами и котировками.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ask на площадке в виде дроби от 0 до 1; null, если недоступен.

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

Bid на площадке в виде дроби от 0 до 1; null, если недоступен.

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

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

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

Метка исхода на площадке.

listings[].outcomes[].position
integer обязательный

Позиция нативного исхода, начиная с нуля.

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

Котировка исхода в виде дроби от 0 до 1; null, если недоступна. Не является социальным сентиментом.

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

provider, last_trade, midpoint или unavailable.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Связанные субъекты. Используйте их существующие аналитические эндпоинты отдельно; рыночные настроения не выводятся.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{
  "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": [
        {
          "ask": 0.66,
          "bid": 0.64,
          "id": "polymarket:123",
          "label": "Yes",
          "position": 0,
          "price": 0.65,
          "price_basis": "provider"
        }
      ],
      "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": [
        "string"
      ],
      "image_url": "https://example.com/nvda.png",
      "name": "NVIDIA",
      "role": "entity",
      "status": "open",
      "subject_id": "eq:NVDA",
      "types": [
        "string"
      ]
    }
  ]
}