Polymarket 开发者 API：数据、CLOB 和 Polygon RPC

Source: Dev.to

请提供您希望翻译的正文内容（除代码块和 URL 之外的文本），我将为您翻译成简体中文并保持原有的 Markdown 格式。

Gamma API – 市场发现

• 公共接口，无需身份验证。
• 提供 Events（顶层问题）和 Markets（具体可交易结果）。
• 每个市场包含一个 outcomePrices 数组，1:1 对应各结果，表示隐含概率（例如 0.62 = 62 % 的 YES 可能性）。
• 可按活跃状态、24 小时成交量、标签、开启/关闭状态等进行过滤。
• 重要提示： 在假设市场拥有实时 CLOB 流动性之前，请先确认 enableOrderBook: true。

CLOB – 混合交易引擎

CLOB 负责链下订单匹配和链上 EIP‑712 结算。

• 访问方式： 官方 SDK（TypeScript、Python、Rust）或原始 REST。
• 认证方式：
  1. L1 – 钱包签名生成 API 凭证，无需消耗 gas。
  2. L2 – 凭证用于每次订单调用的快速 HMAC‑签名请求。
• 订单类型：
  • GTC – Good‑Till‑Cancelled（挂单至取消）
  • GTD – Good‑Till‑Date（限时）
  • FOK – Fill‑Or‑Kill（全额或不成交）
  • FAK – Fill‑And‑Kill（可成交部分成交，其余取消）
• 下单前检查： 有效的 EIP‑712 签名、足够的 USDC.e 余额、已批准的 CTF Exchange 授权以及有效的 L2 凭证。

Data API – 用户级分析

提供钱包的详细分析：

• 各市场的当前持仓。
• 包含时间戳、规模以及已实现/未实现盈亏的完整交易历史。
• 每个钱包的活动动态。

适用于构建仪表盘或随时间分析策略表现。

WebSocket – 实时更新

Four subscription channels:

生产备注： Polymarket 在已认证会话变为非活跃时会取消所有未完成订单。机器人必须定期发送心跳以保持会话活跃。

步骤‑逐‑集成概览

1. 创建一个 Polygon 钱包并用 POL 为其充值。
2. 将 USDC.e 存入你的 Polymarket 个人资料地址。
3. 从你的钱包中获取 L2 API 凭证。
4. 运行 client.setAllowances() 一次，以批准 CTF Exchange。
5. 通过 Gamma API 获取一个市场。
6. 检查订单簿。
7. 通过 CLOB SDK 或 REST 接口下限价单。
8. 订阅相关的 WebSocket 频道以获取实时成交。
9. 在 CTF Exchange 上设置 OrderFilled 事件监听器，以进行链上确认。

这些步骤为分析工具、自动化交易机器人或自定义界面奠定了基础。

官方与社区工具

• clob-client (TypeScript) – 订单下单 & API 凭证处理。
• real-time-data-client – 支持内置重连逻辑的 WebSocket 订阅。
• clob-order-utils – 低层 EIP‑712 订单签名。
• rs-clob-client (Rust)。
• Polymarket Agents (Python) – 基于 LLM 的自主交易参考实现。
• Goldsky‑powered subgraphs – 提供持仓、订单簿、盈亏、未平仓量的 GraphQL 端点。
• Polygon RPC – 通过 Chainstack 的生产级归档访问和 WebSocket。

风险与注意事项

• 市场风险: 预测错误将导致所投入金额的全部损失。
• 流动性风险: 市场流动性不足可能导致深度不足。
• 预言机风险: 若结果存在争议，结算可能会延迟。
• 监管风险: 可能存在地域限制；请确认预测市场在您所在司法辖区的合法性。
• 智能合约风险: 与任何链上平台一样，可能存在漏洞。

仅使用您能够承受损失的资金，并进行适当的尽职调查。

结论

Polymarket API 将预测市场转变为可编程基础设施：

• 在 Polygon 上实现快速、低成本结算。
• 以 USDC.e 为计价的交易。
• 在 Gamma（发现）、CLOB（执行）、Data（分析）和 WebSocket（实时）之间提供简洁的原语。
• 现有的 EVM 工具（Solidity、ethers.js、viem、Foundry）无需修改即可使用。

生态系统仍处于早期阶段，提供了在文档完善、经过审计的合约以及透明的链上历史之上构建交易机器人、概率仪表盘或分析管道的充足机会。

阅读完整文章于 Chainstack 博客