[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-76870":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":14,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":16,"rankGlobal":9,"rankLanguage":9,"license":17,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":9,"pushedAt":9,"updatedAt":28,"readmeContent":29,"aiSummary":30,"trendingCount":14,"starSnapshotCount":14,"syncStatus":31,"lastSyncTime":32,"discoverSource":33},76870,"polymarket-arbitrage","mclaeo\u002Fpolymarket-arbitrage","mclaeo","Polymarket arbitrage trading bot Polymarket arbitrage bot polymarket bot Polymarket arbitrage trading bot Polymarket arbitrage bot polymarket bot Polymarket arbitrage trading bot Polymarket arbitrage bot polymarket bot Polymarket arbitrage trading bot Polymarket arbitrage bot polymarket bot Polymarket arbitrage trading bot Polymarket arbitrage bot",null,"TypeScript",141,4000,27,0,124,10,"MIT License",false,"develop",true,[22,23,24,25,26,27],"arbitrage","bot","nodejs","polymarket","trading","typescript","2026-06-12 02:03:42","# Polymarket 套利机器人\n\n**针对 Polymarket 15 分钟加密货币涨跌市场的自动化「抄底 + 对冲」交易** — TypeScript、官方 CLOB 客户端，可在 **BTC、ETH、SOL、XRP** 上无人值守运行。\n\n本方向活跃开发周期：**2026-01-04** 至 **2026-04-02**。\n\n[![Node.js](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode-%3E%3D16-brightgreen)](https:\u002F\u002Fnodejs.org\u002F)\n[![TypeScript](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTypeScript-5.3-blue)](https:\u002F\u002Fwww.typescriptlang.org\u002F)\n\n## 目录\n\n- [项目背景](#项目背景)\n- [功能说明](#功能说明)\n- [策略流程](#策略流程)\n- [技术栈](#技术栈)\n- [快速开始](#快速开始)\n- [配置](#配置)\n- [项目结构](#项目结构)\n- [免责声明](#免责声明)\n- [运行安全清单](#运行安全清单)\n- [贡献者](#贡献者)\n- [参与贡献](#参与贡献)\n- [故障排查](#故障排查)\n- [许可证](#许可证)\n\n---\n\n## 项目背景\n\n短期预测市场波动极快。当某一侧在几秒内**急跌**时，另一侧往往滞后 —— 若你能以足够低的价格同时买到两条腿，**配对份额的总成本可能低于 1 美元**，从而在结算前锁定结构性优势。\n\n本机器人会**持续监控**这些市场，**识别**符合你阈值的剧烈波动，**执行**两腿周期（抄底 → 对冲），并**跟踪**盈亏 —— 还可选**模拟模式**，在动用真金白银前验证行为。\n\n---\n\n## 功能说明\n\n| 能力 | 说明 |\n|------|------|\n| **多标的** | 可交易一个或多个市场：`btc`、`eth`、`sol`、`xrp`（逗号分隔）。 |\n| **自动发现** | 通过 Polymarket Gamma API 解析每个标的当前活跃的 **15 分钟涨跌**市场，并在每个新周期自动切换。 |\n| **急跌检测** | 利用近期卖一（ask）历史，在短时间窗口内按你的**波动阈值**标记一条腿。 |\n| **对冲逻辑** | 第一条腿成交后，当 **腿1 入场价 + 对侧卖一 ≤ 你的价格和目标**（如 0.95）时再买入第二条腿。 |\n| **风控** | 若在 **N 分钟内**未出现有利对冲，可配置**止损对冲**。 |\n| **结算** | 市场结束时核对输赢，生产环境可对链上**赎回**获胜头寸。 |\n| **日志** | 向 stderr 输出活动，并追加写入 **history** 文件供复盘与审计。 |\n\n---\n\n## 策略流程\n\n```text\n新的 15 分钟轮次\n     │\n     ▼\n┌─────────────────┐     涨或跌一侧快速下跌     ┌──────────────┐\n│ 观察窗口        │ ─────────────────────────► │ 买入急跌侧   │\n│ （前 N 分钟）   │                            │ （腿 1）     │\n└─────────────────┘                            └──────┬───────┘\n                                                      │\n                              对侧卖一足够便宜        │\n                              （合计 ≤ 目标）         ▼\n                                                    ┌──────────────┐\n                                                    │ 买入对冲腿   │\n                                                    │ （腿 2）     │\n                                                    └──────┬───────┘\n                                                           │\n                    超时？ ────────────────────────────────┤\n                                                           ▼\n                                                止损对冲路径\n```\n\n*交易者模块的简化示意图；阈值可通过环境变量调节。*\n\n---\n\n## 技术栈\n\n- **运行时：** Node.js 16+\n- **语言：** TypeScript\n- **Polymarket：** [`@polymarket\u002Fclob-client`](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@polymarket\u002Fclob-client)（下单、鉴权），Gamma + CLOB HTTP API（市场、价格）\n- **链：** Polygon（USDC、CTF 赎回流程）\n\n---\n\n## 快速开始\n\n### 前置条件\n\n- [Node.js](https:\u002F\u002Fnodejs.org\u002F) 16 或更高版本\n- 兼容 Polymarket 的钱包；实盘需在 **Polygon** 上有 USDC，并明确 **EOA 与代理（proxy）** 签名方式（`.env` 中的 `SIGNATURE_TYPE`）\n\n### 安装\n\n```bash\ngit clone repo\ncd polymarket-arbitrage\nnpm install\ncp .env.example .env\n# 编辑 .env — 见下方 [配置](#配置)\nnpm run build\n```\n\n### 运行方式\n\n| 命令 | 用途 |\n|------|------|\n| `npm run dev` | 使用 `ts-node` 从源码运行（开发）。 |\n| `npm run typecheck` | 仅做 TypeScript 检查，不生成 `dist\u002F`。 |\n| `npm run clean` | 删除 `dist\u002F` 下的编译产物。 |\n| `npm run sim` | **模拟** — 记录交易日志，不下真实单（`--simulation`）。 |\n| `npm run prod` | **生产** — 真实 CLOB 下单（`--production`）。 |\n| `npm start` | 运行 `dist\u002Fmain.js`；结合下方参数与 `.env` 使用。 |\n\n**实盘：** 在 `.env` 中设置 `PRODUCTION=true` 并运行 `npm run prod`（或 `node dist\u002Fmain.js --production`），避免进程停留在模拟模式。\n\n---\n\n## 配置\n\n将 `.env.example` 复制为 `.env` 并按需修改。\n\n| 变量 | 作用 |\n|------|------|\n| `PRIVATE_KEY` | 真实下单与赎回所必需。 |\n| `PROXY_WALLET_ADDRESS` | 如使用 Polymarket 代理\u002F档案地址则填写。 |\n| `SIGNATURE_TYPE` | `0` EOA，`1` Proxy，`2` Gnosis Safe（示例中默认为 `2`）。 |\n| `GAMMA_API_URL` | 可选；默认 `https:\u002F\u002Fgamma-api.polymarket.com`。 |\n| `CLOB_API_URL` | 可选；默认 `https:\u002F\u002Fclob.polymarket.com`。 |\n| `API_KEY` \u002F `API_SECRET` \u002F `API_PASSPHRASE` | 可选；若你的环境需要 CLOB API 凭证则填写。 |\n| `MARKETS` | 例如 `btc` 或 `btc,eth,sol,xrp`（逗号分隔、小写）。 |\n| `CHECK_INTERVAL_MS` | 轮询价格的间隔（毫秒，默认 `1000`）。 |\n| `MARKET_CLOSURE_CHECK_INTERVAL_SECONDS` | 检查轮次是否结束的频率（秒，默认 `20`）。 |\n| `DUMP_HEDGE_SHARES` | 每条腿的份额数量。 |\n| `DUMP_HEDGE_SUM_TARGET` | 对冲时两腿价格和的上限（如 `0.95`）。 |\n| `DUMP_HEDGE_MOVE_THRESHOLD` | 视为急跌的最小比例跌幅（如 `0.15` 表示 15%）。 |\n| `DUMP_HEDGE_WINDOW_MINUTES` | 仅在每轮**前 N 分钟**内寻找急跌机会。 |\n| `DUMP_HEDGE_STOP_LOSS_MAX_WAIT_MINUTES` | 若 **N 分钟内**无有利对冲则走止损路径。 |\n| `DUMP_HEDGE_STOP_LOSS_PERCENTAGE` | 强制对冲时价格和的上限：max(腿1 + 对侧) = 1 + 该比例（默认 `0.2`）。 |\n| `PRODUCTION` | `false` 为模拟；实盘请设为 `true` 并与 `--production` 一起使用。 |\n\n---\n\n## 项目结构\n\n```text\nsrc\u002F\n  main.ts            # 入口：发现市场、监控、周期切换\n  monitor.ts         # 价格轮询与快照\n  dumpHedgeTrader.ts # 急跌 → 对冲 → 止损 → 结算跟踪\n  api.ts             # Gamma、CLOB、下单、赎回、活动\n  config.ts          # 环境变量加载\n  models.ts          # 共享类型\n  logger.ts          # history 文件 + stderr\n```\n\n---\n\n## 免责声明\n\n本软件**仅供教育与研究**。预测市场与自动化交易存在**重大财务风险**，包括可能**全部亏损**。历史或模拟表现**绝不**代表未来结果。你须自行遵守适用法律、交易所条款与税务义务。**文中内容不构成投资、法律或税务建议。**\n\n---\n\n## 运行安全清单\n\n- 先跑模拟，在多轮次中检查 `history.toml`。\n- 实盘初期使用较小的 `DUMP_HEDGE_SHARES` 与较保守的阈值。\n- 勿将私钥提交到版本库；已泄露的凭证应及时轮换。\n\n---\n\n## 贡献者\n\n核心开发（2026 年一季度）：[buffalu](https:\u002F\u002Fgithub.com\u002Fbuffalu)、[bunghi](https:\u002F\u002Fgithub.com\u002Fbunghi)、[calvinzhou-rockx](https:\u002F\u002Fgithub.com\u002Fcalvinzhou-rockx)、[Carlosted](https:\u002F\u002Fgithub.com\u002FCarlosted)、[cavemanloverboy](https:\u002F\u002Fgithub.com\u002Fcavemanloverboy)、[ch9xy](https:\u002F\u002Fgithub.com\u002Fch9xy)、[ChewingGlass](https:\u002F\u002Fgithub.com\u002FChewingGlass)、[codemonkey6969](https:\u002F\u002Fgithub.com\u002Fcodemonkey6969)、[cryptogosu](https:\u002F\u002Fgithub.com\u002Fcryptogosu)、[cryptopapi997](https:\u002F\u002Fgithub.com\u002Fcryptopapi997)、[danpaul000](https:\u002F\u002Fgithub.com\u002Fdanpaul000)。\n\n---\n\n## 参与贡献\n\n欢迎提 Issue 与 Pull Request：策略思路、更安全的默认值、测试与更清晰的文档对大家都有帮助。  \n本地流程与提交规范见 [CONTRIBUTING.md](CONTRIBUTING.md)。\n\n---\n\n## 故障排查\n\n- **`Failed to fetch market\u002Forderbook`：** 多为 API 或网络瞬时问题；确认端点与重试逻辑。\n- **生产环境下单失败：** 核对 `PRIVATE_KEY`、`SIGNATURE_TYPE` 与代理钱包设置是否与 Polymarket 账户一致。\n- **找不到市场：** 确认 `MARKETS` 仅包含支持的标的（`btc`、`eth`、`sol`、`xrp`），并等待下一轮 15 分钟开盘。\n\n---\n\n## 许可证\n\n条款见本仓库中的 [LICENSE](LICENSE)。\n","Polymarket 套利机器人是一款针对 Polymarket 15 分钟加密货币涨跌市场的自动化交易工具，支持无人值守运行。该机器人使用 TypeScript 编写，并基于官方 CLOB 客户端，能够持续监控市场波动，识别急跌机会并执行对冲策略，适用于 BTC、ETH、SOL 和 XRP 等多个币种。其核心功能包括自动发现活跃市场、检测急跌行情、智能对冲以及风险控制等，确保在市场波动中捕捉套利机会。此外，项目还提供了模拟模式以帮助用户在实际操作前验证策略效果。此工具适合有一定技术背景且希望利用算法进行高频交易的投资者或开发者使用。",2,"2026-05-19 02:34:03","CREATED_QUERY"]