所有 API

經濟預測市場 API 賠率查詢

依主題和帶日期的事件查詢經濟數據發布和政策決定的市場隱含機率。可取得最新賠率、從分鐘到日的歷史以及即時資料串流。

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

首次請求

取得主題詳情

curl --request GET \
  --url "https://api.narwhalapi.com/v1/predictions/topics/usa-cpi-yoy" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
回應範例
{
  "topic_id": "usa-cpi-yoy",
  "group": "us_prices",
  "title": "US CPI, 12-month change",
  "shape": "scalar",
  "unit": "percent",
  "venues": [
    "kalshi",
    "polymarket"
  ],
  "resolution_kind": "release",
  "events": [
    {
      "event_id": "usa-cpi-yoy-2026-09",
      "question": "US CPI, 12-month change, September 2026",
      "status": "trading",
      "closes_at": "2026-10-14T12:29:00Z",
      "resolves_at": "2026-10-14T12:30:00Z"
    }
  ]
}

端點

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 秒傳送一次。


完整參考文件 →

使用情境

聯準會利率決策機率

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

閱讀指南 →

Polymarket 對比 Kalshi

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

閱讀指南 →

將報價視為機率

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

閱讀指南 →

機率變動時提醒

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

閱讀指南 →

涵蓋範圍

顯示全部 37 個主題

來源

相關 API

經濟數據 API

價格、勞動力、產出、貿易與利率的官方指標。

探索 API →

大宗商品 API

包含原始單位與序列定義的現貨金屬與實物大宗商品價格。

探索 API →

Kalshi 機率 API

透過 Narwhal 取得 Kalshi 機率,附上每個結果對應的 Kalshi 代號。

瀏覽此頁 →

Polymarket 機率 API

透過 Narwhal 取得 Polymarket 機率,附上每個結果對應的 Polymarket 市場。

瀏覽此頁 →

常見問題

這些是官方經濟數值嗎?

不是。這些是市場隱含機率。經濟事件以官方發布的數據結算,經濟 API 也會公布該數據。

賠率有延遲嗎?

沒有。所有帳戶的賠率都是即時的。

提供哪些歷史資料與串流存取?

API 提供從分鐘到日的賠率歷史。即時資料串流對所有帳戶開放,每次連線計 1 次呼叫。

事件包含什麼?

一個問題、收盤與結算時間、官方結算來源,以及狀態:upcoming、trading、closed、settled 或 void。

事件有哪些型態?

純量分布、二元機率、極端高低點與時間點市場,另有央行政策路徑。

這些主題涵蓋什麼?

涵蓋範圍包括經濟數據發布與央行利率決策。經濟事件以官方發布的數據結算。