name: polymarket-api
description: Polymarket交易操作。统一入口scripts/trade.py，slug驱动，零browser纯API。Triggers: 'polymarket交易', 'API下单', 'buy YES', 'sell NO', 'trade', 'price', '仓位'.
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]
示例
python3 "$SKILL_DIR/scripts/trade.py" buy bitcoin-above-on-march-28 NO 10 --threshold 68000
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 正常
