登入取得 API 金鑰

所有 API

Narwhal 的 Kalshi API 賠率

以同一種 Narwhal 結構讀取 Kalshi 與 Polymarket 對央行決策、CPI、就業、GDP、金屬與能源的機率。Narwhal 是唯讀的。

取得免費 API 金鑰

閱讀文件 →

在線100.00% uptime, last 30天288 ms 一般回應

首次請求

取得事件機率

curl --request GET \
  --url "https://api.narwhalapi.com/v1/predictions/scalar/usa-fed-2026-10" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

2026 年 10 月聯準會決策的回應範例，精簡為兩個結果

{
  "event_id": "usa-fed-2026-10",
  "topic_id": "usa-fed",
  "question": "Federal Reserve rate decision, 28 October 2026",
  "status": "trading",
  "closes_at": "2026-10-28T17:59:00Z",
  "resolves_at": "2026-10-28T18:00:00Z",
  "release_id": "ae2a77cc-3b5b-4541-a060-3bc2ea1145d9",
  "resolution": "Change in the Federal Reserve policy rate announced at the meeting, in basis points",
  "resolves_with": "/v1/economics/USA/central-bank/policy-rate",
  "unit": "bps",
  "venues": [
    {
      "venue": "kalshi",
      "weight": "0.3353",
      "volume_24h_usd": "15376.51"
    },
    {
      "venue": "polymarket",
      "weight": "0.6647",
      "volume_24h_usd": "531149.67"
    }
  ],
  "outcomes": [
    {
      "key": "cut_25",
      "label": "Cut of 25 bps",
      "lower": "-37.5",
      "upper": "-12.5",
      "probability": "0.0059",
      "quotes": [
        {
          "venue": "kalshi",
          "probability": "0.0049",
          "market_ids": [
            "KXFEDDECISION-26OCT-C25"
          ]
        },
        {
          "venue": "polymarket",
          "probability": "0.0064",
          "market_ids": [
            "3326851035…5947"
          ]
        }
      ]
    },
    {
      "key": "cut_50_plus",
      "label": "Cut of 50 bps or more",
      "lower": null,
      "upper": "-37.5",
      "probability": "0.0026",
      "quotes": [
        {
          "venue": "kalshi",
          "probability": "0.0050",
          "market_ids": [
            "KXFEDDECISION-26OCT-C26"
          ]
        },
        {
          "venue": "polymarket",
          "probability": "0.0015",
          "market_ids": [
            "1701037799…5586"
          ]
        }
      ]
    }
  ]
}

端點

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/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。

完整參考文件 →

WS透過 WebSocket 訂閱即時賠率/v1/predictions/stream

透過 WebSocket 取得即時賠率。在 Authorization 標頭中傳送金鑰，然後訂閱。每次連線計 1 次呼叫。

參數

action必填
subscribe.
topics陣列
最多 40 個主題 ID。
event_ids陣列
最多 200 個事件 ID。

訊息

snapshot訊息
完整事件，附上其型態。
update訊息
事件變動時再次傳送，最多每分鐘一次。
status訊息
事件的新狀態。
heartbeat訊息
每 30 秒傳送一次。

完整參考文件 →

使用情境

聯準會利率決策機率

讀取聯準會每場即將舉行的會議降息、不變與升息的機率。

閱讀指南 →

Polymarket 對比 Kalshi

在同一個問題上比較兩個交易場所，並查看兩者的差距。

閱讀指南 →

將報價視為機率

將價格轉為隱含機率，並去除 overround。

閱讀指南 →

機率變動時提醒

依排程執行腳本，機率越過門檻時收到提醒。

閱讀指南 →

即時更新

開啟 WebSocket、訂閱並處理重新連線。

閱讀指南 →

涵蓋範圍

顯示全部 27 個主題

來源

KalshiKalshi 市場資料指南
PolymarketPolymarket API 概覽

相關 API

Polymarket 機率 API

相同主題的 Polymarket 機率，格式相同。

瀏覽此頁 →

預測市場 API

來自 Kalshi 與 Polymarket 的經濟與商品機率，採同一種結構。

Polymarket Kalshi API 參考文件

端點、欄位、交易場所角色、歷史資料與 WebSocket 串流。

閱讀參考文件 →

常見問題

這是 Kalshi 的官方 API 嗎？

不是。Narwhal 讀取 Kalshi 的公開市場資料，並以自己的格式與 Polymarket 並列回傳。若要交易，或讀取 Narwhal 未涵蓋的市場，請使用 Kalshi 自己的 API。

可以透過 Narwhal 下單交易嗎？

不行。Narwhal 是唯讀的。它回傳機率與背後的交易場所市場，不提供委託單或委託簿。

Kalshi 機率有多新？

賠率每 60 秒讀取一次。所有帳戶都能看到即時賠率，並可使用資料串流和 webhook。

為什麼要透過 Narwhal 讀取 Kalshi？

Kalshi 與 Polymarket 採同一種結構，並提供混合機率、分鐘級歷史資料、每個市場所結算的官方發布項目連結、webhook 與 MCP 工具。

我會拿到哪些 Kalshi 代號？

每個結果列出其背後的 Kalshi 市場代號，並與同一問題的 Polymarket 市場和混合機率並列。

市場有對應到官方發布嗎？

每個市場都連結到其結算所依據的官方發布項目。

提供哪些歷史資料、串流與 webhook？

可讀取最近 30 天記錄的分鐘歷史。所有帳戶還可取得即時賠率、WebSocket 資料串流，以及市場關閉或結算時的 webhook。

涵蓋哪些 Kalshi 市場？

Narwhal 使用 Kalshi 的市場來涵蓋「涵蓋範圍」下列出的經濟與商品主題。體育、政治與其他 Kalshi 市場不在其中。