用途:当需要围绕 Polymarket 预测市场(Polygon)构建交易或数据读取能力时使用,涵盖认证、下单、行情、WebSocket、仓位与跨链等操作。
主要能力:Polymarket API 认证(L1 EIP-712、L2 HMAC-SHA256、builder headers、API 密钥与凭证生命周期);订单管理(限价、市价、GTC、GTD、FOK、FAK、批量、撤销,post-only 仅限 GTC/GTD);行情与订单簿(价格、价差、中间价、深度,事件、市场、按 slug/tag 查询、分页);WebSocket 订阅(market、user、sports 频道);CTF 操作(split、merge、redeem 仓位);负风险市场(多结果、转换、增强负风险);跨链桥充提;无 Gas 交易(relayer 客户端、订单归因);Builder 计划集成;TypeScript @polymarket/clob-client 与 Python py-clob-client 的 SDK 用法。
接口与用法要点:CLOB 为 https://clob.polymarket.com,交易端点需 L2 认证;Gamma/Data 与 WebSocket 市场频道无需认证,用户频道需在消息中带 API 凭证。常用流程为先通过 L1 派生 API 凭证(TS 的 createOrDeriveApiKey、Python 的 create_or_derive_api_creds),再以凭证初始化交易客户端;下单示例使用 createAndPostOrder/create_and_post_order,需从 getTickSize/getNegRisk 或 market 对象获取 tickSize 与 negRisk。签名类型:0=EOA、1=POLY_PROXY、2=GNOSIS_SAFE。FOK/FAK 买单 amount 为花费金额,卖单为份额数。
适用场景:构建 Polymarket 交易机器人、行情监控、订单簿分析、事件驱动订阅或持仓管理。
限制:资料为技术集成说明,未提供收费、价格、收益或效果信息;使用需自备钱包私钥、API 凭证与 Polygon 合约地址;EOA 类型需 POL 支付 Gas;参考文档按需加载(认证、订单、行情、WebSocket、CTF、桥、无 Gas)。