所有文件 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) 必填

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

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

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

markets[].listings[].volume_unit
string 必填

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

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
}