所有 API

通过 Narwhal 获取 Polymarket API 赔率

在同一个 Narwhal 数据结构中读取 Polymarket 和 Kalshi 关于央行决议、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）。

阅读指南 →

概率变动提醒

按计划运行脚本，当概率越过阈值时收到提醒。

阅读指南 →

覆盖范围

显示全部 49 个主题

来源

相关 API

Kalshi 概率 API

相同主题的 Kalshi 概率，格式一致。

浏览本页 →

预测市场 API

Kalshi 和 Polymarket 的经济与大宗商品概率，统一在一个数据结构中。

探索 API →

预测市场 API 参考：Kalshi 与 Polymarket

端点、字段、交易场所角色、历史数据和 WebSocket 数据流。

阅读参考文档 →

常见问题

这是 Polymarket 官方 API 吗？

不是。Narwhal 读取 Polymarket 的公开市场数据，并以自己的格式返回，与 Kalshi 并列。如需交易或读取 Narwhal 未覆盖的市场，请使用 Polymarket 自己的 API。

可以通过 Narwhal 下单交易吗？

不能。Narwhal 是只读的。它返回概率以及背后的交易场所市场，不提供订单或订单簿。

Polymarket 概率的时效性如何？

赔率每 60 秒读取一次。所有账户都能看到实时赔率，并可使用数据流和 webhook。

为什么要通过 Narwhal 读取 Polymarket？

Polymarket 和 Kalshi 共用一个数据结构，提供综合概率、分钟级历史、各市场所依据结算的官方发布链接、webhook 和 MCP 工具。

我会得到哪些 Polymarket 市场 ID？

每个结果列出其背后的 Polymarket 市场，以及同一问题下的 Kalshi 代码和综合概率。

市场与官方数据发布是否匹配？

每个市场都链接到其所依据结算的官方发布。

提供哪些历史数据、数据流和 webhook？

可读取最近 30 天记录的分钟历史。所有账户还可获得实时赔率、WebSocket 数据流，以及市场关闭或结算时的 webhook。

覆盖哪些 Polymarket 市场？

Narwhal 使用 Polymarket 上“覆盖范围”中列出的经济和大宗商品主题的市场。体育、政治、加密货币价格及其他 Polymarket 市场不包含在内。