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 或 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/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 或 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 或 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。
完整参考文档 →
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 或 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 美元免费额度，无需绑卡。