登录获取 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 或 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 或 occurrence。
calendar字段
该主题所跟踪的日历发布系列，含国家和系列。没有时则省略。
next_event_id字段
该主题第一个未结束的事件。没有时则省略。

完整参考文档 →

GET列出带日期的事件/v1/predictions/events

跨主题的带日期事件，附带状态和时间。可按主题、形态、状态或结算时间筛选。

参数

topic可选
仅限此主题 ID 的事件。
shape可选
仅限此形态的事件。
status可选
upcoming、trading、closed、settled 或 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 或 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 或 binary。
event_id必填
事件 ID，例如 usa-cpi-yoy-2026-09。
at可选
过去已记录的某一分钟，使用 UTC。

响应字段

event_id字段
事件 ID。
topic_id字段
该事件所属的主题。
question字段
该事件提出的问题。
status字段
upcoming、trading、closed、settled 或 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 或 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 的经济与大宗商品概率，统一在一个数据结构中。

预测市场 API 参考：Kalshi 与 Polymarket

端点、字段、交易场所角色、历史数据和 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 市场不包含在内。