跳到主要内容

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 签署 CLOB ClobAuth EIP-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

字段默认值
enabledfalse
gamma_base_urlhttps://gamma-api.polymarket.com
clob_base_urlhttps://clob.polymarket.com
timeout_secs15

USDC 授权

get_usdc_allowance 仅报告授权状态;它不改变链状态。

  • Token: Polygon 上的 USDC.e
  • Spender: Polymarket exchange

错误和重试行为

  • 4xx 错误被视为客户端错误,不重试
  • 429 和 5xx 错误被视为瞬态,最多重试 3 次
  • 重试之间固定 500ms 退避

下一步