預測市場詳情

GET /predictions/market
GetPredictionMarket

合約規則、結果、場所觀測值與關聯主體。待處理的主體將交由既有解析器處理。不會推斷合併的市場情緒。

可使用錢包於 https://nebula-api.hiddensystems.ai/api/v1/x402/predictions/market 付款。不需要 Nebula 帳號或 API 金鑰;簽署前請先確認付款條件。x402 付款指南。

參數

market_id string QUERY 必填

來自 /predictions 的穩定市場或掛牌 ID

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) 必填

Nebula 擷取此報價的 UTC 時間。比較前請先檢查資料的新鮮度。

listings[].open_interest
number (double) 必填

交易場所的未平倉合約數;無法取得時為 null。

listings[].opens_at
string (date-time) 必填

交易場所的開盤時間(UTC);無法取得時為 null。

listings[].outcomes
array<object> 必填

依序排列的原生結果,各自具有獨立的價格證據。

listings[].outcomes[].ask
number (double) 必填

交易場所的賣價,以小數表示,範圍 0 到 1;無法取得時為 null。

listings[].outcomes[].bid
number (double) 必填

交易場所的買價,以小數表示,範圍 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) 必填

以 volume_unit 計的最近 24 小時場所成交量;無法取得時為 null。

listings[].volume_unit
string 必填

Polymarket 使用 usd,Kalshi 使用 contracts。這些數量無法相加。

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"
      ]
    }
  ]
}