Polymarket 交易 API：数据、订单和账户

Polymarket 交易 API 接口图

国际版接口图包括用于市场发现的 Gamma、用于订单簿和订单操作的 CLOB、用于分析账户活动的 Data API，以及用于受支持钱包交易的 Relayer。这些是相互关联的服务，而不是一个通用端点的不同名称。

从应用需要回答的问题开始。“哪个合约涉及此事件？”属于发现。“此价格提供多少数量？”属于市场深度。“此账户是否购入目标份额？”需要账户和订单证据。

这种以问题为基础的方法，让集成更易理解。方便的客户端库可能通过一个对象暴露多种服务，但底层观察仍有不同含义和认证要求。应用应在记录中保留区别，而不是将每个响应都视为对账户当前状态同样权威。

将国际版与美国版体系分开

Polymarket US 维护自己的文档和集成模型。程序应在选择凭证格式、市场标识符或订单请求之前，确定支持哪个体系。品牌相似不能证明账户语义兼容。

将体系与每个连接和已存记录关联。如果应用同时支持二者，应明确选择，并分别验证每项能力。在一个环境发现的市场，不应仅因可见问题熟悉就路由到另一个环境。

资格和产品支持也仍是账户专用事项。读取公开信息，不同于获准通过特定账户提交订单。集成应解释这一边界，而不提出绕过限制的方法，也不暗示拥有 API 凭证就能普遍访问市场。

理解事件、市场和结果层级

官方市场数据概览区分事件分组、市场问题，以及用于定价和交易的结果代币。保留层级，可以防止将宽泛事件元数据与具体可交易权利混淆。

对于关于计划发布的假设事件，多个市场可能询问不同阈值。事件标题组织这些市场，但订单必须识别确切问题和所选结果。不能仅因共享同一事件，就将一个阈值的概率估计附到每个结果上。

层级应在应用模型中保持可见。它让组合能够归组相关风险敞口，同时仍正确核对各笔订单。将所有内容压平到单一标题字段，会让首个界面更容易构建，却在账户之后需要解释拥有哪项权利时制造歧义。

Polymarket 交易 API 的市场数据

Polymarket 交易 API 市场数据具有多种用途：描述合约、报告当前状态，以及展示价格或活动。应用应知道每个字段支持什么用途。描述性结束日期与当前接受订单标记，并不回答同一问题。

发现结果可以帮助定位候选，却不证明它们立即可交易。候选审查仍需要目标操作所要求的确切结果映射和当前约束。元数据缺失应保持为限制，而不是猜测默认值的理由。

将观察时间和来源与重要值一起存储。记录可以作为有效历史证据，却太旧而不能用于新执行决定。数据层应展示区别，防止策略代码将每个缓存字段都当作同样新鲜的市场描述。

读取所选结果的订单簿

订单簿描述已识别结果代币的可用买卖意向。因此，选择正确结果是解释档位的前提。不能仅因属于同一问题，就将 No 的订单簿当作 Yes 的订单簿。

在应用模型中区分买价、卖价、中间价和最近成交。寻求立即执行的买方，通常需要相关卖单及其数量，而最近成交报告已经发生的事情。中间价是从订单簿推导的参考，不是保证存在的对手方。

对于假设请求，20 份按 0.41 出售，30 份按 0.43 出售，则成本为 8.20 加 12.90，50 份在手续费之前合计 21.10。可执行规模计算，比单一显示报价 0.41 传达更多信息。

将市场约束保留在订单背景附近

市场允许的价格增量、最低订单要求和其他相关标记，应属于准备订单所用背景。策略不应依赖从文档示例复制的一套全局假设。

这些约束可能影响拟议金额是否有效，却不改变底层预测。模型可能仍看好某结果，但所需数量过小，或拟议价格不符合当前市场规则。

按照受支持接口行为刷新必要约束。如果观察到相关变化，使依赖过时值的提案失效。实际目标是清晰连接经济意图与表达它的技术有效请求，而不让格式变化悄然增加允许占用。

从预测到限价的计算说明，将理论购买上限向上舍入，为何即使产生技术有效订单，也可能削弱经济规则。

区分公共数据流与私有更新

官方实时市场文档将公共市场更新与已认证订单和成交更新分开描述。公共订单簿变化可以为策略提供信息，却不能对特定账户请求给出确定结论。

订阅实际工作流需要的通道，并保留其范围。如果应用只观察公共数据，就不应将推断的私有成交展示得仿佛账户已确认。靠近用户价格的市场成交，可能涉及别人。

反向区别也重要。账户更新不一定为下一决定提供完整公共订单簿快照。每个数据流提供含义具体的观察。当集成通过明确标识符和状态规则结合它们，而不是假设一个数据源能代替其他所有来源时，才会可靠。

按照各自约定使用快照和更新

有些消息描述当前状态，另一些描述变化。应用需要文档语义，才能知道如何应用。将更新当作完整快照可能丢弃有效信息，将快照当作增量则可能重复计入。

断开连接后，确定通道实际提供什么连续性。不要假设所有遗漏事件都会重放。如果本地状态可能不完整，先获取适当当前证据，再用于有重大后果的决定。

保留恢复范围。重建市场订单簿不会自动核对私有订单，重新连接私有通道也不会自动刷新合约规则。集成可以恢复一项能力，而另一项仍过时。就绪报告应让这种部分恢复容易理解。

Polymarket 订单簿采集器指南将这一区别扩展为只读收集工作流，明确缺口、时间戳含义，以及经过版本管理的历史观察。

Polymarket 交易 API 的账户集成

Polymarket 交易 API 账户集成，首先识别账户钱包、签名者安排和受支持权限。这些角色可能不同，应用不应假设用于认证的地址始终是与持有量相关的唯一身份。

为所选账户配置使用当前文档路径。不要仅因某凭证仍能认证读取，就沿用旧钱包假设。必须为最终拥有持仓的账户确立运营能力。

保持凭证私密且范围明确。账户记录可以包含非秘密的体系引用和连接修订，而不将可复用秘密与市场数据存放在一起。预测市场机器人 API 指南解释了为什么权限应有自己的模型，而不是隐藏在通用已连接标记中。

认证不能证明资金可用

认证响应确认的是某时刻关于凭证和操作的某些事实。它不能证明账户负担得起下一提案、必需权限已到位，或每个所需市场都受支持。

检查具体操作需要的账户证据。购买依赖可用抵押品和适用占用；卖出依赖相关可用结果份额。这是不同资源检查。

假设账户策略额度为 100 单位，已有请求占用 70，则新的 50 单位提案，不符合简化剩余容量 30。认证成功不会改变这些算术。集成应直接报告资源限制，而不是将其表现为连接问题，或盲目尝试不同请求。

Polymarket 交易 API 的订单生命周期

Polymarket 交易 API 订单生命周期，将已授权意图连接到订单证据及后续账户影响。提交只是序列中的一个事件。接受、开放数量、撮合成交和最终确认，需要适当区分表示。

当前实时订单更新文档提供账户范围的订单和成交观察。应用应将这些观察与自身请求记录关联，并检查涉及数量，而不是依赖一条宽泛成功消息。

对于假设 75 份订单，购入 25、剩余 50 开放，会同时形成库存和持续占用。界面应同时显示。如果应用后来取消余量，取消不会抹去已购入的 25 份。订单记录与持仓记录保持关联，但回答不同问题。

理解取消响应证明什么

取消操作针对当前服务和市场状态下仍可取消的订单。应在适当范围解释其响应，尤其当一个请求包含多个订单时。

不要仅因 HTTP 请求本身成功完成，就推断每个目标都已取消。返回结果可能区分各订单结果，账户也可能需要继续观察，以确定剩余持有量和占用。

假设取消可以与它生效前发生的成交并存。因此，集成应一起核对订单数量和持仓证据。运营者需要知道移除了什么未来风险敞口，以及还剩哪些份额，而不只是应用成功发送取消消息。

区分分析活动与即时账户事实

活动和持仓分析有助于解释历史行为，但在将它们作为即时账户决定的唯一依据之前，应理解更新时间和范围。方便摘要可能回答不同于当前订单查询的问题。

使用适合所需证据的接口。公共历史可以支持研究某钱包行为，而管理自身未解决请求，可能需要已认证订单和成交记录。未确定观察足够充分之前，集成不应以一种代替另一种。

记录暂时不一致时，保留差异并调查含义。不同时间戳、覆盖或最终性阶段，可以解释表面矛盾。选择最容易显示的值，可能隐藏运营者为理解资金或份额是否真正可用而需要的区别。

有意识地处理历史分页

历史响应通常是一页有边界的记录。应用应遵循当前接口分页约定，并识别何时已到达预期范围末尾。第一页不自动等于完整账户历史。

对重复观察去重，同时不丢弃有意义修正。如果扫描从更早位置重启，不应将同一成交再次计为新经济事件。修订状态仍应以其证据时间更新适当记录。

保持扫描覆盖可见。报告可以合理总结近期活动，前提是说清如此。如果将有限范围展示为终身表现，或据此推断未观察持仓从未存在，就会误导。完整性是账户查询含义的一部分。

区分交易与钱包操作

订单操作和钱包交易可能属于集成不同部分。交易通过受支持订单行为改变持仓，而其他钱包操作可能通过自身生命周期管理抵押品或结果代币。

客户端库可能让这些操作看起来相似，但应用应保留不同授权和确认要求。返回标识符可能意味着请求已被接受处理，而不证明由此产生的余额变化已完成。

官方交易概览连接订单、结算和持仓。对于应用设计者，实际教训是建模真正发生的转换。存入、购买、合并和赎回，不应仅因改变账户余额就全部归为通用交易利润。

跨接口追踪一项假设持仓

假设应用发现一个虚构事件、选择一个二元问题，并识别其 Yes 代币。它读取相关订单簿，准备已授权的 50 份限价提案，并收到证据：20 份已购入，30 份仍开放。

发现记录解释权利，订单簿记录解释观察到的价格背景，订单记录解释未完成请求。持仓记录显示已购入 20 份。这些记录中任何一份，都无法单独讲完账户故事。

如果剩余订单之后取消，持有份额最终结算，集成应将这些后续事件连接到同一合约和账户历史。这说明稳定标识符为何比一组漂亮却互不关联的界面更重要。有用结果，是从发现直到最终处理都能跟随持仓的解释。

在操作层面报告能力

宽泛的 API 可用状态可能掩盖部分支持。发现可能正常，而认证账户读取失败；订单读取可能正常，而某项钱包操作不受支持。界面应识别这些区别。

为策略实际需要的操作维护能力记录。说明体系、账户范围、当前证据和已知限制。在一种市场结构或钱包配置中确立的能力，不应悄然成为其他所有情况的证明。

这份记录也让维护更聚焦。当官方数据结构或账户流程变化，团队可以识别哪些能力依赖受影响行为。没有这张关系图，集成可能继续显示已连接，尽管账户生命周期中某关键步骤已不符合实现。

将结算证据视为独立边界

成交完成，不同于其份额代表的事件结算。账户可能在底层问题有答案很久之前就成功购入代币。集成不应将成交确认字段当作描述事件最终结果的字段。

同样，停止接受订单的市场，仍可能需要进一步解释其结算状态及账户剩余权利。应用需要相关证据，才能将持有量移入已结算结果类别。交易界面关闭，本身不能证明每项相关持仓都已赎回。

对于假设标准二元持仓，20 份按 0.45 买入，费用之前成本为九个单位。如果后来每份获得一个单位的获胜支付，则赎回总值为 20。购买确认确定已购入持仓；后续结果和赎回证据确定额外账户变化。这些观察属于同一历史，却描述不同事件。

在整个生命周期保持必需引用相连。这样组合报告能区分当前持有量、预期权利和实际可用抵押品，也防止持仓从结果代币转向最终账户处理时，应用重复计算同一经济价值。

根据任务选择集成细节

研究应用可能只需要公共发现和定价。订单管理工具需要账户权限和核对。组合应用需要完整持仓和活动证据。按任务选择必要接口，让设计保持易懂。

更直接控制，也带来更多签名、数据结构、重试和状态责任。高层客户端可以处理部分机制，但应用仍需理解操作含义。便利不会免除验证经济意图和检查结果的必要性。

预测市场交易软件指南讨论了这些更广责任。有用的 Polymarket 交易 API 集成，将每项操作连接到清晰问题、保留账户背景，并让证据限制可见。这才会将分散服务响应转为可审查交易工作流。

相关指南与完整示例

• Polymarket API 交易机器人：可审计客户端 — 设计具有已验证数据和可重建操作身份的 API 客户端。
• Polymarket 机器人 API：能力与失效模式 — 在决定是否重试之前，定义适配器能力并分类故障。