核心用法
Polymarket Trading Setup 是一套面向开发者的预测市场自动化交易基础设施配置方案，旨在解决从钱包准备到首单成交的全链路技术部署问题。该技能的核心价值在于将 Polymarket 复杂的四接口架构（Gamma API、CLOB REST/WS、Data API、Builder API）整合为可执行的七步标准化流程。
使用流程遵循严格的依赖顺序：首先验证现有环境配置（.env 与 config.json），随后完成代理钱包（Proxy Wallet）的 USDC funding 与合约授权——这是区分普通 EOA 与交易持仓地址的关键设计。API 凭证通过 py-clob-client 的 derive_api_key() 方法从私钥派生，形成三要素（key/secret/passphrase）持久化存储。最后的连通性验证需依次通过 Gamma 事件查询、CLOB 订单簿读取、Data API 持仓查询三重测试，最终以极小仓位（2 shares @ 0.02）的限价单完成端到端验证。
显著优点
1. 架构完整：覆盖链上授权、链下签名、实时数据、历史数据四大 API 面，无遗漏
2. 风险隔离：强制使用代理钱包分离持仓与签名权限，降低私钥暴露风险
3. 故障可诊断：提供 6 类常见首次失败场景的对照表，缩短调试周期
4. 版本锁定：明确依赖 py-clob-client>=0.28.0，避免 API 变更导致的兼容性故障
5. 生产就绪：区分 UI 授权（新手）与无头授权（服务器部署）双路径
潜在缺点与局限性
- 门槛较高：需熟悉 Polygon 网络、ERC-20 授权机制及 Python 异步编程
- 资金门槛：最小订单价值 $1.00，策略回测成本高于纯模拟环境
- 链上依赖：Token 授权与 USDC 转账需支付 MATIC Gas，服务器部署需额外管理热钱包资金
- 实时性局限：WebSocket 订阅格式易错（对象 vs 数组），且 MATCHED 状态不可靠，必须等待 MINED 确认
- 价格精度敏感：价格需按区间强制截断（<0.04 或 >0.96 时 3 位小数，否则 2 位），策略计算需额外处理
适合人群
- 具备 Ethereum/Polygon 开发经验的量化策略工程师
- 需将预测市场数据接入自有交易框架的机构或 DAO
- 希望自动化套利 Polymarket 与中心化交易所价差的高级交易者
- 研究信息市场（information markets）的学术开发者
常规风险
1. 智能合约风险：USDC 需授权给 Polymarket 的四个核心合约，若合约遭攻击可能导致资金损失
2. 私钥泄露：.env 文件若未纳入 .gitignore 或权限管理不当，私钥可能被意外提交
3. 代理地址混淆：频繁出现的「EOA 地址误当 Proxy 地址」错误会导致持仓查询为空、余额不足等连锁故障
4. 订单误成交：测试订单若未设置足够偏离市场的价格，可能在流动性突变时被意外撮合
5. 网络分叉风险：Polygon PoS 虽稳定，但极端情况下 reorg 可能导致 MINED 状态回滚，需设计幂等重试机制