PolyGate

统一的 Polymarket 命令网关。一个 HTTP 服务即可完成市场查询、CLOB 深度查看和鉴权交易执行。

运行时: Cloudflare Workers 命令数: 94 基础路径: /api/v1 Base URL: https://polygate.w0x7ce.eu

核心接口

可直接打开用于健康检查和命令发现。

方法路径说明
GET/health服务健康状态
GET/api/v1/commands可用命令列表
GET/api/v1/commands/:command单命令详情与示例
GET/api/v1/manifest完整命令元数据清单
GET/api/v1/events/stream实时事件流(SSE)
POST/api/v1/commands/execute执行命令请求

Web 控制台

直接在页面选择命令并执行,无需手写 curl。

使用流程

建议先只读,再接入鉴权交易。

  • 只读快速上手: markets.list -> clob.book -> data.positions
  • 交易快速上手: wallet.info -> approve.check -> clob.createOrder
  • 鉴权命令需要配置 `POLYMARKET_PRIVATE_KEY`
  • 生产前先用小仓位做下单验证。

只读快速上手

无需钱包配置。

curl -X POST "https://polygate.w0x7ce.eu/api/v1/commands/execute" \
  -H 'content-type: application/json' \
  -d '{"command":"markets.list","params":{"limit":10}}'

交易快速上手

需要运行时密钥。

curl -X POST "https://polygate.w0x7ce.eu/api/v1/commands/execute" \
  -H 'content-type: application/json' \
  -d '{"command":"clob.createOrder","params":{
    "tokenID":"123456789","side":"BUY","price":0.42,"size":10,"orderType":"GTC"
  }}'

命令分类

常用命名空间一览。

  • markets.* / events.* / tags.* / series.*
  • data.* 地址级分析、持仓、排行榜
  • clob.* 公共行情与私有交易执行
  • approve.*ctf.* 链上操作

文档入口

中英文 README 与 curl 手册。

故障排查

高频错误与修复建议。

  • UNKNOWN_COMMAND:从 /api/v1/commands 复制正确命令名
  • VALIDATION_ERRORparams 字段名或类型不匹配
  • WALLET_REQUIRED:鉴权命令缺少运行时钱包密钥
  • UPSTREAM_ERROR:上游接口超时或失败,先重试并降低并发
  • 生产建议:对交易路径启用 Access、WAF 和严格限流

基础地址

下方示例命令默认使用这个地址。

export BASE_URL="https://polygate.w0x7ce.eu"