polymarket-api

---

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]

示例

# 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 正常