alchemist-x/all-polymarket-skill/api-trade-polymarket

Polymarket CLOB API 交易执行

非交互式交易执行层，通过 $ARGUMENTS 接收指令，调用 Polymarket CLOB API 完成操作并返回结构化 JSON 结果。

工作流

按顺序执行，不可跳过。

第 0 步：环境准备

cd ~/.claude/skills/api-trade-polymarket/scripts && npm install 2>/dev/null

验证 .env.aizen 存在（位于 scripts/ 目录下）。若不存在，提示用户参照 .env.aizen.example 创建。

第 1 步：解析指令

从 $ARGUMENTS 中提取操作类型和参数。支持的操作：

第 2 步：市场解析（买入/卖出/订单簿操作需要）

当指令包含 --market <slug>，需要将 market slug 和 direction 转换为 CLOB token ID：

1. 通过 Polymarket Gamma API 查询市场信息：

`` GET https://gamma-api.polymarket.com/events?slug=<slug> ``

1. 从返回的 market 数据中，根据 --direction 找到对应 outcome 的 clobTokenId
2. 如果 API 查询失败，提示用户直接提供 --token-id

第 3 步：预检查（买入/卖出操作需要）

余额检查：

cd ~/.claude/skills/api-trade-polymarket/scripts && npx tsx balance.ts

验证 USDC 余额充足。

订单簿读取（限价单需要）：

cd ~/.claude/skills/api-trade-polymarket/scripts && npx tsx orderbook.ts --token-id <id> --side BUY|SELL --urgency medium

如果用户未指定价格但选择限价单，使用返回的 smart_price 作为限价。

风控验证：

• 单笔金额不超过 $500（安全上限）
• 价格在 best_bid 和 best_ask 范围内合理
• 余额足够覆盖交易

第 4 步：执行操作

根据操作类型调用对应脚本：

买入/卖出：

# 市价单 (FOK)
cd ~/.claude/skills/api-trade-polymarket/scripts && npx tsx trade.ts --token-id <id> --side BUY|SELL --order-type FOK --amount <usd>
 
# 限价单 (GTC)
cd ~/.claude/skills/api-trade-polymarket/scripts && npx tsx trade.ts --token-id <id> --side BUY|SELL --order-type GTC --price <p> --size <shares>

撤单：

cd ~/.claude/skills/api-trade-polymarket/scripts && npx tsx cancel.ts --order-id <id>
cd ~/.claude/skills/api-trade-polymarket/scripts && npx tsx cancel.ts --all

余额查询：

cd ~/.claude/skills/api-trade-polymarket/scripts && npx tsx balance.ts

持仓查询：

cd ~/.claude/skills/api-trade-polymarket/scripts && npx tsx positions.ts

订单簿：

cd ~/.claude/skills/api-trade-polymarket/scripts && npx tsx orderbook.ts --token-id <id> [--side BUY|SELL] [--urgency low|medium|high] [--depth 5]

第 5 步：更新组合状态

如果执行了买入/卖出操作且成功，更新 ~/polymarket-reports/portfolio.json：

• status=matched/filled → 添加到 positions，扣减 cash_balance
• status=live → 添加到 pending_orders，记录 real_order_id
• 撤单成功 → 从 pending_orders 移除，恢复 cash_balance

第 6 步：输出结果

将脚本输出的 JSON 直接返回给调用者。所有脚本输出格式统一包含 status 字段。

错误处理

• 环境缺失 → 返回 {"error": "...", "status": "config_error"}
• 参数错误 → 返回 {"error": "...", "status": "arg_error"}
• API 失败 → 返回 {"error": "...", "status": "execution_error"}
• 执行出错时自动调用 cancelAll() 清理

参考文件

• references/clob-trading-api.md — CLOB API 端点文档
• references/env-setup.md — .env.aizen 配置指南