用途：面向需要接入 Polymarket 预测市场的开发者，说明其交易所机制与 API 使用方式。Polymarket 是 Polygon 主网上的预测市场，每个市场是一对由 Conditional Token Framework（CTF）发行的 YES/NO ERC-1155 代币，以 USDC 1:1 抵押，链下 CLOB 撮合、链上结算，无 taker 费用，价格区间为 [0.00, 1.00] USDC。
主要能力与接口：Gamma API（https://gamma-api.polymarket.com，无需认证）提供事件/市场/条件/价格元数据；CLOB API（https://clob.polymarket.com，EIP-712 认证）提供订单簿与下单/撤单；Data API（https://data-api.polymarket.com，无需认证）提供历史成交；WebSocket（wss://ws-subscriptions-clob.polymarket.com/ws/）提供实时行情，市场频道无需认证，用户频道需 JWT。链为 Polygon 主网 chain_id=137，抵押品为 USDC.e（0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174）。
标识符模型：需区分 condition_id（链上市场条件 ID）、clob_token_ids（YES/NO 两个 ERC-1155 代币 ID 的列表）、token_id（单个结果代币，用于订单簿与 WebSocket 查询）、event_id（父级分组）。
使用方式：官方推荐使用 Python SDK py-clob-client（安装命令 uv pip install py-clob-client），它处理 EIP-712 派生、API 凭证管理与订单签名；仅在 SDK 未暴露所需功能时手写 HTTP。Gamma 查询需注意默认按最旧排序，应显式覆盖排序与 closed 参数，分页用 limit=100&offset=N。CLOB 客户端需传入钱包私钥（仅用环境变量，切勿硬编码）与 signature_type（2 为 Gnosis Safe 代理账户，0 为自控 EOA），并调用 set_api_creds(create_or_derive_api_creds())。
结算与限制：市场结算后获胜代币需在链上手动调用 CTF 合约 redeemPositions() 赎回，收益不会自动划入钱包；争议升级至 UMA 乐观预言机。美国用户被禁止使用 Polymarket，美国 IP 调用通常需经允许司法辖区的 SOCKS5 代理。文档提醒端点与认证流程可能无预警变更，编码前应先阅读实时文档（https://docs.polymarket.com）。