Polymarket 對比 Kalshi
在同一個問題上比較兩個交易場所，並查看兩者的差距。
閱讀指南 →所有 API
商品預測市場 API 機率查詢
依主題和帶日期的事件查詢金屬和能源事件的市場隱含機率。可取得最新賠率、從分鐘到日的歷史以及即時資料串流。
首次請求
取得主題詳情
curl --request GET \
--url "https://api.narwhalapi.com/v1/predictions/topics/xau-settle" \
--header "Authorization: Bearer $NARWHAL_API_KEY"端點
GET列出預測主題/v1/predictions/topics
Narwhal 涵蓋的每個主題，附上型態、單位與交易場所。用它來找主題 ID。
參數
group選填central_banks, us_prices, us_jobs, us_activity, global_activity, global_prices, metals or energy.
清單中的每個主題
topic_id欄位主題 ID，例如 usa-cpi-yoy。
group欄位主題所屬的群組，例如 central_banks 或 metals。
title欄位主題名稱。
shape欄位機率的呈現方式，例如 scalar 或 binary。
unit欄位數值的單位，例如 usd_per_barrel。沒有時則省略。
venues欄位報價的交易場所：kalshi、polymarket 或兩者。
resolution_kind欄位release, price_fix, price_window or occurrence.
calendar欄位該主題所跟隨的日曆發布系列，附上國家與系列。若沒有跟隨任何系列則省略。
next_event_id欄位該主題第一個未結事件。沒有時則省略。
完整參考文件 →
GET取得主題詳情/v1/predictions/topics/{topic_id}
單一主題，附上即將舉行與交易中的事件，以及最近 5 個其他事件。
參數
topic_id必填主題 ID，例如 usa-cpi-yoy。
回應欄位
topic_id欄位主題 ID，例如 usa-cpi-yoy。
group欄位主題所屬的群組，例如 central_banks 或 metals。
title欄位主題名稱。
shape欄位機率的呈現方式，例如 scalar 或 binary。
unit欄位數值的單位，例如 usd_per_barrel。沒有時則省略。
venues欄位報價的交易場所：kalshi、polymarket 或兩者。
resolution_kind欄位release, price_fix, price_window or occurrence.
calendar欄位該主題所跟隨的日曆發布系列，附上國家與系列。若沒有跟隨任何系列則省略。
events欄位每個事件有 event_id、question、status、closes_at、resolves_at、release_id 與 result。
完整參考文件 →
GET列出有日期的事件/v1/predictions/events
跨主題的有日期事件，附上狀態與時間。可依主題、型態、狀態或結算時間篩選。
參數
topic選填僅限此主題 ID 的事件。
shape選填僅限此型態的事件。
status選填upcoming, trading, closed, settled or void.
release_id選填僅限在此日曆發布項目上結算的事件。
from, to選填篩選 resolves_at 的 UTC 時間。from 必須早於 to。
limit選填1 到 100。預設為 50。
cursor選填傳入上一頁的 next_cursor 以讀取下一頁。
清單中的每個事件
event_id欄位事件 ID。
question欄位事件所問的問題。
status欄位upcoming, trading, closed, settled or void.
closes_at, resolves_at欄位收盤與結算時間，以 UTC 計。
topic_id, shape欄位主題及其機率的型態。
release_id欄位事件所結算的日曆發布項目。沒有時則省略。
result欄位對已結算與無效的事件，說明結果是否為最終結果以及結算時間。
next_cursor欄位下一頁的游標。最後一頁為 Null。
完整參考文件 →
GET依型態取得事件機率/v1/predictions/{shape}/{event_id}
單一事件的最新機率，附上各交易場所的報價與混合機率。
參數
shape必填scalar, extreme, timing or binary.
event_id必填事件 ID，例如 usa-cpi-yoy-2026-09。
at選填過去已記錄的某一分鐘，使用 UTC。
回應欄位
event_id欄位事件 ID。
topic_id欄位事件所屬的主題。
question欄位事件所問的問題。
status欄位upcoming, trading, closed, settled or void.
closes_at欄位收盤時間，以 UTC 計。
resolves_at欄位結算時間，以 UTC 計。
as_of欄位交易場所最近一次檢查的時間。
stale欄位當最近一次交易場所檢查超過 3 分鐘前時為 true。
resolution欄位說明事件如何結算的文字描述。
resolves_with欄位公布官方數值的 Narwhal 端點。沒有時則省略。
venues欄位每個交易場所市場一筆記錄：連結、規則、結算來源、權重、成交量與未平倉量。
result欄位各平台的結果，在事件結算或作廢後給出。
outcomes純量每個結果有 key、label、lower、upper、probability 與 quotes。
up, down極值在區間內達到各高點或低點水準的機率。
steps時間到各個日期或會議時已發生的機率。
probability二元「是」的機率，附上其背後的報價。
quotes欄位各交易場所的機率，以及其背後的 Kalshi 代號或 Polymarket 市場 ID。
完整參考文件 →
GET取得事件的歷史機率/v1/predictions/{shape}/{event_id}/history
單一事件隨時間變化的機率，以 K 線呈現。
參數
shape必填scalar, extreme, timing or binary.
event_id必填事件 ID，例如 usa-cpi-yoy-2026-09。
interval選填1m、5m、1h（預設）或 1d。1m 與 5m 的 K 線保留 30 天。
start必填起始時間，以 UTC 計。
end必填結束時間，以 UTC 計，晚於 start。1m 最多 2 天，5m 最多 7 天，1h 最多 92 天，1d 最多 3,660 天。
cursor選填傳入上一頁的 next_cursor，並使用相同的 start、end 與 interval。
回應欄位
series欄位每個結果一條序列，各附 key、active_from 與 bars。
bars欄位每根 K 線有 timestamp（K 線起點）與 close。即時 K 線另有 open、high 與 low。
active_to欄位序列結束後傳送一次。
next_cursor欄位下一頁的游標。最後一頁為 Null。
完整參考文件 →
GET取得央行政策路徑/v1/predictions/policy-paths/{authority}
每場即將舉行的會議降息、不變與升息的機率，附上以基點計的預期變動。
參數
authority必填federal-reserve, european-central-bank, bank-of-england, bank-of-japan, bank-of-canada, reserve-bank-of-australia or bank-indonesia.
回應欄位
as_of欄位取得機率的時間。
meetings欄位每場即將舉行的會議一列，附上 event_id 與 resolves_at。
p_cut, p_hold, p_hike欄位降息、不變與升息的機率。
expected_change_bps欄位該會議的機率加權變動，以基點計。
cumulative_change_bps欄位各場會議累計的預期變動。
完整參考文件 →
WS透過 WebSocket 訂閱即時賠率/v1/predictions/stream
透過 WebSocket 取得即時賠率。在 Authorization 標頭中傳送金鑰，然後訂閱。每次連線計 1 次呼叫。
參數
action必填subscribe.
topics陣列最多 40 個主題 ID。
event_ids陣列最多 200 個事件 ID。
訊息
snapshot訊息完整事件，附上其型態。
update訊息事件變動時再次傳送，最多每分鐘一次。
status訊息事件的新狀態。
heartbeat訊息每 30 秒傳送一次。
完整參考文件 →
使用情境
涵蓋範圍
- 銅在指定時間的價格金屬
- 年底前黃金期貨的最高價與最低價金屬
- 白銀每月最高價與最低價金屬
- 白銀在指定時間的價格金屬
- 白銀當日上漲或下跌金屬
- 白銀每週最高價與最低價金屬
- 黃金每月最高價與最低價金屬
- 黃金在指定時間的價格金屬
- 黃金當日上漲或下跌金屬
- 黃金每週最高價與最低價金屬
- 布蘭特原油在指定時間的價格能源
- 原油價格是否在指定日期前創歷史新高能源
顯示全部 20 個主題
來源
- KalshiKalshi 市場資料指南
- PolymarketPolymarket API 概覽
相關 API
常見問題
這些是商品現貨價格嗎？
不是。此 API 回傳市場隱含的商品事件機率，包括價格水準結果。
賠率有延遲嗎？
沒有。所有帳戶的賠率都是即時的。
可以取得歷史機率或使用串流嗎？
可取得從分鐘到日的賠率歷史。所有帳戶也可使用即時資料串流，每次連線計 1 次呼叫。
事件包含什麼？
一個問題、收盤與結算時間、官方結算來源，以及狀態：upcoming、trading、closed、settled 或 void。
事件有哪些型態？
純量分布、二元機率、極端高低點與時間點市場，另有央行政策路徑。
這些主題涵蓋什麼？
黃金與白銀的涵蓋範圍包括價格水準，以及每週或每月的高低點，另有其他金屬與能源商品。
從免費金鑰開始
12 個月內每月贈送 10 美元免費額度，無需綁卡。每月 10 美元免費額度，無需綁卡。