【用途】 该技能是一个自动化 dump-and-hedge（砸盘—对冲）套利交易机器人，面向 Polymarket 的 15 分钟加密货币 Up/Down 预测市场，支持的标的为 BTC、ETH、SOL、XRP。其思路是：在每轮 15 分钟开始后的指定时间窗内监控两条腿（Up 与 Down）的价格，当某一腿价格出现足够幅度的急跌时先买入该腿，再在其对立腿报价足够便宜、使两腿合计成本低于目标阈值时买入对冲腿，从而在结算前锁定结构性价差。
【主要能力】
- 市场发现：通过 Gamma API 按标签查找当前活跃的 15 分钟市场（如 BTC-15m），取最早结束的活跃市场，并支持多资产并行监控。
- 价格轮询与快照：按 CHECK_INTERVAL_MS 定时从 CLOB API 的 orderbook 获取最优卖价并记录历史快照。
- 砸盘检测：在轮次前 DUMP_HEDGE_WINDOW_MINUTES 分钟内，比较窗口内最高卖价与当前卖价，跌幅达到 DUMP_HEDGE_MOVE_THRESHOLD（默认 15%）即触发第一腿买入。
- 对冲与止损：当两腿合计成本不超过 DUMP_HEDGE_SUM_TARGET（默认 0.95）时买入对冲腿；若等待超过 DUMP_HEDGE_STOP_LOSS_MAX_WAIT_MINUTES（默认 8 分钟）仍未满足条件，则执行强制止损对冲。
- 下单与结算：使用 CLOB 客户端创建订单（示例中使用 Fill-or-Kill 市价买入），并在轮次结束后通过 redeemPositions 在 Polygon 上赎回获胜代币（实盘模式）。
- 模拟与实盘：npm run sim 为模拟模式，只记录交易日志不真实下单；npm run prod 为生产模式，提交真实 CLOB 订单。npm start 默认模拟，需传入 --production 才实盘。
- 日志记录：将每笔交易写入 history.toml，并输出到 stderr；提供 troubleshooting 表与安全清单。
【安装与运行方式】 git clone https://github.com/apechurch/polymarket-arbitrage-trading-bot.git cd polymarket-arbitrage-trading-bot npm install cp .env.example .env
配置 .env
npm run build
要求：Node.js 16+、Polygon 上的 USDC（实盘交易）、Polymarket 兼容钱包。
关键命令：
- npm run dev：通过 ts-node 运行（开发，无需构建）
- npm run build：编译 TypeScript 到 dist/
- npm run typecheck：仅类型检查不输出
- npm run clean：删除 dist/ 目录
- npm run sim：模拟模式，记录交易但不真实下单
- npm run prod：生产模式，提交真实 CLOB 订单
- npm start：运行编译产物（除非传入 --production，否则默认模拟）
【配置项（.env）】 钱包与认证：PRIVATE_KEY、PROXY_WALLET_ADDRESS、SIGNATURE_TYPE（0=EOA，1=Proxy，2=Gnosis Safe）。 交易市场：MARKETS=btc,eth,sol,xrp（逗号分隔）。 轮询：CHECK_INTERVAL_MS=1000。 策略阈值：DUMP_HEDGE_SHARES=10（每条腿份额）、DUMP_HEDGE_SUM_TARGET=0.95（两腿合计最高价）、DUMP_HEDGE_MOVE_THRESHOLD=0.15（触发最小跌幅 15%）、DUMP_HEDGE_WINDOW_MINUTES=5（仅检测轮次前 N 分钟的砸盘）、DUMP_HEDGE_STOP_LOSS_MAX_WAIT_MINUTES=8（超时后强制止损对冲）。 模式：PRODUCTION=false（实盘需使用 --production 命令行标志）。 可选 API 覆盖：GAMMA_API_URL、CLOB_API_URL、API_KEY、API_SECRET、API_PASSPHRASE。
【代码结构】 src/main.ts（入口：市场发现、监控、轮次切换）、monitor.ts（价格轮询与快照）、dumpHedgeTrader.ts（核心策略：砸盘→对冲→止损→结算）、api.ts（Gamma API、CLOB API、下单、赎回）、config.ts（环境变量加载）、models.ts（共享 TypeScript 类型）、logger.ts（history.toml 与 stderr 日志）。
【流程概述】 新一轮 15 分钟开始 → 观察前 DUMP_HEDGE_WINDOW_MINUTES 分钟 → 若 Up 或 Down 某腿跌幅达到阈值则买入该腿（Leg 1）→ 若对立腿卖价足够便宜使合计成本 ≤ DUMP_HEDGE_SUM_TARGET 则买入对冲腿（Leg 2）锁定价差；否则在 DUMP_HEDGE_STOP_LOSS_MAX_WAIT_MINUTES 超时后执行止损对冲 → 轮次结束，结算获胜方并在链上赎回（实盘）。
【适用场景】 适用于熟悉 Polymarket 与 CLOB API、希望在 15 分钟加密涨跌市场中按预设阈值自动执行砸盘对冲策略的用户；可先以模拟模式在多轮中验证策略与轮次切换逻辑，再以小额份额进入实盘。
【限制与风险提示（来自资料）】 支持标的仅限 btc、eth、sol、xrp；需先执行 npm run build 再 npm start/npm run prod，否则可能出现找不到模块的错误；实盘下单失败通常与认证配置不符有关，需核对 PRIVATE_KEY、SIGNATURE_TYPE、PROXY_WALLET_ADDRESS 与 Polymarket 账户一致；模拟模式只记录日志不下单属预期行为；止损超时会在不利价格强制对冲，可能侵蚀价差。安全清单建议：始终先模拟并检查 history.toml、首次实盘使用低份额（如 1）、将 .env 加入 .gitignore 切勿提交版本控制、谨慎调整止损等待时间、确保 Polygon 上有足够 USDC，并在模拟中确认轮次自动切换日志正确。
其余未在资料中说明的功能、收费、价格、平台或效果，暂未提供。