Polymarket API 中转接入指南

先选择接入方式

需要沿用上游响应格式、搜索市场或读取盘口时，选择原生 API 中转。需要独立复核某个市场和结果的盘口、留存分析依据时，选择 v2 市场证据快照。二者共享租户身份，但用途和上游请求数不同。当前证据搜索和快照仅接受已适配的 version=v2 市场，案例来自 canary 集合，不代表全部常规市场的快照覆盖。

接入流程

1. 先看真实历史案例和公开套餐价格。新用户选择套餐后直接在 Stripe 付款，无需提前注册。
2. 付款由服务端确认。新邮箱创建普通账户，原付款浏览器可自动登录；已有邮箱须先验证归属后关联，不会仅凭付款邮箱接管旧账户。关闭页面或换浏览器时，使用付款邮箱登录。
3. 在控制台确认套餐开通状态，再创建所需权限的 API Key。不要将 Key 放在公开网页或客户端代码中。
4. 登录阅读接口文档，下载对应 OpenAPI，在自己的服务端完成接入。
5. 先验证市场与结果资产，再处理盘口、分页和上游错误。使用证据快照时保留响应证据与请求编号。
6. 在控制台核对用量；遇到错误，通过售后提交请求编号和发生时间。

本页为公开接入概览。具体路由、输入字段、鉴权格式和错误契约以登录后的文档为准。

可以查询哪些数据？

当前目录覆盖七类服务：市场与事件、盘口与价格、持仓与数据分析、钱包交易状态、跨链报价与状态、组合市场及永续合约。首页列出各类能力。接口可用性取决于上游支持、市场状态和所需账户权限，目录覆盖不表示所有路径在任何时间都返回有效数据。

如何核验盘口数据？

先核对市场、结果和资产身份，再检查原始响应与 SHA-256。源时间反映上游可验证的时间，接收时间反映本服务的观测时间；源时间缺失时保留为空。不要把接收时间当作盘口更新时间，也不要把固定演示样本用于真实交易。

调用额度与上游请求数

Pro 每分钟 60 次、每月 500000 次。Max 每分钟 300 次、每月 3000000 次。一次证据快照可能读取多份上游数据，所以客户调用数与上游请求数分开记录。原生中转的每次分页都需要应用发起新请求。上游限速和错误仍可能影响结果。

交易写入的当前状态

Pro / Max 的首批 CLOB 下单、撤单中转已开放，需账户启用写入并使用具备写权限的 Key。WebSocket 尚未提供。本站不代开户、不托管钱包、不代签；中转地点不能替代用户所需的上游账户资格。