Polymarket 集成
polymarket 工具现在支持通过以下 API 对市场浏览和交易:
- Gamma API (
https://gamma-api.polymarket.com) - CLOB API (
https://clob.polymarket.com)
支持的读取操作
| 操作 | 说明 |
|---|---|
list_markets | 列出市场 |
get_market | 获取市场详情 |
list_events | 列出事件 |
get_orderbook | 获取订单簿 |
get_price | 获取价格 |
get_positions | 获取持仓 |
get_balance | 获取余额 |
get_open_orders | 获取未完成订单 |
get_usdc_allowance | 获取 USDC 授权 |
支持的写入操作
| 操作 | 说明 |
|---|---|
place_order | 下单 |
cancel_order | 取消订单 |
认证和签名流程
L1 握手(一次性引导)
- 使用 Polygon chain id
137签署 CLOBClobAuthEIP-712 payload - 调用
POST /auth/api-key;如需要,回退到GET /auth/derive-api-key - 持久化返回的
{ apiKey, secret, passphrase }用于 L2
L2 认证请求
每个认证的 CLOB 请求签署:
timestamp + method + request_path (+ body for POST)
订单签名
place_order 使用域签署 EIP-712 订单:
- name:
Polymarket CTF Exchange - version:
1 - chain id:
137
配置
配置路径:integrations.polymarket
| 字段 | 默认值 |
|---|---|
enabled | false |
gamma_base_url | https://gamma-api.polymarket.com |
clob_base_url | https://clob.polymarket.com |
timeout_secs | 15 |
USDC 授权
get_usdc_allowance 仅报告授权状态;它不改变链状态。
- Token: Polygon 上的 USDC.e
- Spender: Polymarket exchange
错误和重试行为
- 4xx 错误被视为客户端错误,不重试
- 429 和 5xx 错误被视为瞬态,最多重试 3 次
- 重试之间固定 500ms 退避