Polymarket API Trading Skill Skill

Polymarket API Trading Skill

⚠️ 强制使用 scripts/trade.py，禁止直接调用CLOB API。

脚本目录

skills/polymarket-api/scripts/
└── trade.py    # 统一交易入口（买/卖/查价/查仓位）

命令

# === 交易 ===
python3 "$SKILL_DIR/scripts/trade.py" buy <slug> <YES/NO/UP/DOWN> <金额> [--threshold N] [price]
python3 "$SKILL_DIR/scripts/trade.py" sell <slug> <YES/NO> <金额> [--threshold N] [price]

# === 查询 ===
python3 "$SKILL_DIR/scripts/trade.py" price <slug> <YES/NO> [--threshold N]
python3 "$SKILL_DIR/scripts/trade.py" info <slug> [--threshold N]

示例

# BTC>$68k Mar28 买NO $10
python3 "$SKILL_DIR/scripts/trade.py" buy bitcoin-above-on-march-28 NO 10 --threshold 68000

# BTC涨跌盘 买DOWN $8
python3 "$SKILL_DIR/scripts/trade.py" buy btc-up-or-down-on-march-27-2026 DOWN 8

# 查价
python3 "$SKILL_DIR/scripts/trade.py" price ethereum-above-on-april-21 YES --threshold 2300

参数说明

| 参数 | 必填 | 说明 | |------|------|------| | slug | ✅ | Gamma slug (e.g. bitcoin-above-on-march-28) | | side | ✅ | YES/NO/UP/DOWN | | 金额 | buy必填 / sell可选 | USDC金额，sell默认全部 | | --threshold N | 多market时 | Above盘阈值，如68000 | | price | 可选 | 默认自动定价(MID+1¢买/BID-1¢卖) |

Slug格式

| 类型 | 格式 | 示例 | |------|------|------| | Above盘 | {coin}-above-on-{month}-{day} | bitcoin-above-on-march-28 | | 涨跌盘 | {ticker}-up-or-down-on-{month}-{day}-{year} | btc-up-or-down-on-march-27-2026 |

底层SDK（仅脚本内部使用）

py-clob-client-v2@1.0.0 — CLOB V2订单簿 (2026-04-28上线，V1已弃用)
py-builder-relayer-client — Relayer链上操作 (redeem/approve)
凭证: .env.poly (POLY_PRIVATE_KEY + POLY_PROXY_WALLET + POLY_API_KEY/SECRET/PASSPHRASE)

V2迁移记录 (2026-05-02)

OrderArgs 移除 fee_rate_bps, V2自动计算
OrderArgs 移除 nonce, V2用 timestamp
下单默认 FOK (Fill or Kill)
Cloudflare 对 create_or_derive_api_key 有403干扰，但 fallback 正常

Agent Skills: Polymarket API Trading Skill

Install this agent skill to your local

Skill Files