[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-81074":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":15,"stars7d":16,"stars30d":16,"stars90d":14,"forks30d":14,"starsTrendScore":17,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":9,"pushedAt":9,"updatedAt":23,"readmeContent":24,"aiSummary":25,"trendingCount":14,"starSnapshotCount":14,"syncStatus":16,"lastSyncTime":26,"discoverSource":27},81074,"okx-grid-bot-monitor","QiYongchuan\u002Fokx-grid-bot-monitor","QiYongchuan","OKX ETH 永续合约网格策略监控 + 自动调仓工具",null,"JavaScript",46,13,44,0,1,2,3,3.44,false,"master",true,[],"2026-06-12 02:04:10","# OKX Grid Bot Monitor & Auto-Trader\n\n> ETH 永续合约网格策略监控 + 自动调仓工具\n>\n> 基于 OKX Trading Bot API，支持模拟盘验证与实盘交易。\n\n---\n\n## 项目简介\n\n这是一个围绕 **OKX 网格交易策略** 的自动化监控与调仓工具，核心解决一个问题：\n\n> 当价格偏离网格区间时，自动停止旧机器人并在新价格区间重建网格，让策略始终\"追得上\"行情。\n\n项目最初为 OKX 交易大赛设计，包含完整的策略验证文档、自动化脚本和监控体系。\n\n---\n\n## 功能特性\n\n| 功能 | 说明 |\n|------|------|\n| 网格状态监控 | 每 5 分钟扫描一次，检查机器人运行状态、挂单数量、持仓盈亏 |\n| 自动调仓 | 价格突破区间或横盘太久时，自动停旧 bot → 建新 bot |\n| 多模式支持 | `demo`（模拟盘，可真实自动交易）\u002F `live`（实盘，仅监控） |\n| 风控保护 | 冷却期（默认 1 小时）、日交易上限（默认 2 次）、防负价保护 |\n| 日志追溯 | NDJSON 结构化日志 + 人类可读通知文件，完整可追溯 |\n| Windows 计划任务 | 开箱即用的 PowerShell 脚本，一键注册定时任务 |\n\n---\n\n## 项目结构\n\n```text\nokx-demo\u002F\n├── scripts\u002F\n│   ├── monitor.js              # 核心监控 + 自动交易脚本（Node.js）\n│   ├── run-monitor.ps1         # PowerShell 包装器（验证环境后执行）\n│   ├── run-monitor.vbs         # VBS 包装器（后台无窗口运行）\n│   └── setup-scheduler.ps1     # 一键注册 Windows 计划任务\n├── runtime\u002F                    # 运行时日志（gitignore，不提交）\n│   ├── latest-state.json       # 最新状态快照\n│   ├── monitor-log.ndjson      # 完整监控日志\n│   ├── alert-log.ndjson        # 告警日志\n│   ├── notifications.txt       # 人类可读通知\n│   ├── auto-trade-config.json  # 自动交易配置\n│   └── auto-trade-state.json   # 自动交易状态\n├── data\u002Fhistorical\u002F            # 历史复盘数据（参考）\n├── skill\u002F                      # 策略文档\n│   ├── 01-历史证据.md\n│   ├── 02-赚钱机制.md\n│   ├── 03-当前市场判断.md\n│   └── 04-比赛执行方案.md\n├── deploy\u002F                     # 部署相关 Skill 文档\n├── README.md                   # 本文件\n└── .gitignore\n```\n\n---\n\n## 前置依赖\n\n1. [Node.js](https:\u002F\u002Fnodejs.org\u002F) ≥ 18\n2. [OKX Trade CLI](https:\u002F\u002Fwww.okx.com\u002Fdownload) (`npm install -g @okx_ai\u002Fokx-trade-cli`)\n3. 已配置 CLI profile：\n   ```bash\n   okx --profile demo ...   # 模拟盘\n   okx --profile live ...   # 实盘\n   ```\n\n---\n\n## 快速开始\n\n### 1. 安装依赖\n\n确保全局安装 OKX CLI：\n\n```bash\nnpm install -g @okx_ai\u002Fokx-trade-cli\n```\n\n### 2. 配置自动交易（可选）\n\n编辑 `runtime\u002Fauto-trade-config.json`：\n\n```json\n{\n  \"enabled\": true,\n  \"targetInstId\": \"ETH-USDT-SWAP\",\n  \"targetBot\": \"first\",\n  \"triggers\": {\n    \"aboveBy\": 50,           # 价格超出区间上限 50 USDT 时触发上移\n    \"belowBy\": 50,           # 价格跌破区间下限 50 USDT 时触发下移\n    \"noLiveOrdersChecks\": 12  # 连续 12 次无活跃挂单（60分钟）触发横盘重建\n  },\n  \"newBot\": {\n    \"gridNum\": 12,           # 网格数量\n    \"lever\": 2,              # 杠杆倍数\n    \"sz\": 200,               # 单格投资额\n    \"direction\": \"long\",     # 做多方向\n    \"rangeHalfWidth\": 100    # 新区间半宽（当前价 ±100）\n  },\n  \"cooldownMs\": 3600000,     # 交易冷却期：1 小时\n  \"maxDailyTrades\": 2        # 日交易上限\n}\n```\n\n### 3. 运行监控\n\n```bash\n# 模拟盘模式（默认，支持自动交易）\nnode scripts\u002Fmonitor.js\n\n# 模拟盘 + 只看不交易\nnode scripts\u002Fmonitor.js --dry-run\n\n# 实盘模式（仅监控，不自动交易）\nnode scripts\u002Fmonitor.js --live\n```\n\n### 4. 注册 Windows 定时任务\n\n```powershell\n# 以管理员身份运行 PowerShell\n.\\scripts\\setup-scheduler.ps1\n\n# 查看任务状态\nGet-ScheduledTask -TaskName 'OKX-Grid-Monitor-Demo'\n\n# 立即执行一次\nStart-ScheduledTask -TaskName 'OKX-Grid-Monitor-Demo'\n\n# 移除任务\n.\\scripts\\setup-scheduler.ps1 -Remove\n```\n\n---\n\n## 自动交易触发逻辑\n\n```\n每 5 分钟检查一次：\n├─ 价格 > 区间上限 + aboveBy   → 触发上移重建\n├─ 价格 \u003C 区间下限 - belowBy   → 触发下移重建\n└─ 区间内但 N 次无活跃挂单    → 触发横盘重建\n\n触发后检查安全阀：\n├─ 冷却期是否已过？\n├─ 当日交易次数是否 \u003C maxDailyTrades？\n└─ 新区间价格是否为正？\n\n全部通过 → 执行：停旧 bot → 建新 bot\n```\n\n---\n\n## 日志说明\n\n| 文件 | 格式 | 说明 |\n|------|------|------|\n| `latest-state.json` | JSON | 最新一次检查的快照（覆盖） |\n| `monitor-log.ndjson` | NDJSON | 所有检查记录（追加） |\n| `alert-log.ndjson` | NDJSON | 仅告警记录（追加） |\n| `notifications.txt` | 文本 | 人类可读通知（追加） |\n\n---\n\n## 风险提示\n\n⚠️ **本项目仅供学习研究，不构成投资建议。**\n\n- 模拟盘（`demo`）模式下，自动交易也是真实的模拟交易，会产生模拟盈亏。\n- 实盘（`live`）模式默认**关闭**自动交易，仅作监控，需手动修改代码开启。\n- 网格策略在**单边行情**中会亏损，请确保理解策略原理后再使用。\n- 建议先用模拟盘跑至少 3 个完整往返（买→卖→利润确认）验证策略有效性。\n\n---\n\n## 技术栈\n\n- **Node.js** — 核心脚本\n- **PowerShell** — Windows 环境集成\n- **OKX Trade CLI** — 与 OKX API 交互\n- **Windows Task Scheduler** — 定时触发\n\n---\n\n## 作者\n\n- **我真的没有拼多多**（X: [@nopinduoduo](https:\u002F\u002Fx.com\u002Fnopinduoduo)）\n- AI 搭档：AI_kevin\n\n> 还没有 OKX 账号？用我的邀请链接注册，可享 **20% 手续费减免**：https:\u002F\u002Fwww.growthhubzz.com\u002Fjoin\u002F52171722\n\n---\n\n## License\n\nMIT License — 自由使用，风险自负。\n","这是一个针对OKX ETH永续合约的网格策略监控与自动调仓工具，基于OKX Trading Bot API开发，支持模拟盘验证和实盘交易。核心功能包括每5分钟一次的网格状态扫描、当价格偏离预设区间时自动停止旧机器人并在新价格区间重建网格，确保策略能及时响应市场变化。项目还提供了多模式支持（模拟盘\u002F实盘）、风控保护机制如冷却期和日交易上限设置，以及详细的日志记录便于追溯。适合需要自动化管理ETH永续合约网格交易策略的个人或团队使用，在追求高效且安全地执行复杂交易策略方面表现优异。","2026-06-11 04:03:24","CREATED_QUERY"]