[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-92590":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":9,"archived":17,"fork":17,"defaultBranch":18,"hasWiki":19,"hasPages":17,"topics":20,"createdAt":9,"pushedAt":9,"updatedAt":41,"readmeContent":42,"aiSummary":43,"trendingCount":14,"starSnapshotCount":14,"syncStatus":44,"lastSyncTime":45,"discoverSource":46},92590,"grid-pilot","QuantiaAI\u002Fgrid-pilot","QuantiaAI","超越交易所原生网格机器人：用程序模拟盯盘交易员——动态改单不挂死、追踪建仓避免顶部接盘、Maker 优先省手续费、分层算法单止损、多段价格区间自适应。兼容 Binance \u002F OKX \u002F Gate.io，内置 12 种语言。| Beyond exchange-native grid bots — a programmatic live trader: dynamic re-quoting instead of set-and-forget, trailing entry, Maker-first fee savings, layered algo stop-loss, adaptive multi-zone. Binance \u002F OKX \u002F Gate.io · 12 languages.",null,"TypeScript",97,21,11,0,46,45.63,false,"main",true,[21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40],"algorithmic-trading","automated-trading","binance","crypto-trading","cryptocurrency","fintech","futures-trading","gateio","grid-trading","market-making","nestjs","nextjs","okx","perpetual-futures","quant","quantitative-trading","trading-bot","trading-strategy","typescript","web3","2026-07-22 04:02:06","# GridPilot\n\n> ETH\u002FUSDT 永续合约**动态网格**交易平台 · 兼容 Binance \u002F Gate.io \u002F OKX\n> 像盯盘交易员一样实时决策，而非把单子挂上去就不管。\n\n**简体中文** · [繁體中文](README.zh-TW.md) · [English](README.en.md) · [日本語](README.ja.md) · [Español](README.es.md) · [العربية](README.ar.md) · [Français](README.fr.md) · [Português](README.pt.md) · [Italiano](README.it.md) · [한국어](README.ko.md) · [ไทย](README.th.md) · [Tiếng Việt](README.vi.md)\n\n---\n\n## 📸 界面预览\n\n| 仪表盘 · 总览 | 费用与返佣 |\n|:---:|:---:|\n| ![GridPilot 仪表盘](docs\u002Fscreenshots\u002Fzh\u002Fdashboard.png) | ![费用与返佣](docs\u002Fscreenshots\u002Fzh\u002Ffees.png) |\n\n> 深青色品牌主题 · Space Grotesk \u002F IBM Plex 字体 · 内置 12 种语言，界面随语言切换。\n\n## 🎯 为什么是网格交易？\n\n网格交易把一段价格区间切成若干\"网格线\"，价格每跌一格就买、每涨一格就卖——**在震荡行情里反复高抛低吸，把波动本身变成收益**。它不预测涨跌，只赚区间内来回波动的差价，因此特别适合无明确趋势、上下震荡的市场。\n\n与\"买入持有\"相比：买入持有只在最终上涨时获利；网格在横盘震荡中持续积累一笔笔小利润。代价是需要持续管理订单、控制风险——这正是 GridPilot 要替你自动化的部分。\n\n> ⚠️ 网格交易并非稳赚：单边下跌时仍会浮亏，杠杆会放大风险。请先理解策略再投入。\n\n## 🚀 我们对交易所原生网格的 5 大创新\n\n交易所自带的网格机器人，本质是\"一次性批量挂单、挂上不动、等市场来撞单\"。GridPilot 的核心差异是**用程序模拟一个有经验的盯盘交易员**：\n\n| 维度 | 交易所原生网格 | GridPilot |\n|------|----------------|-----------|\n| **下单方式** | 批量静态挂单，挂出后不再移动 | 自动化盯盘：每次行情更新都重新判断后才动态下单\u002F改单\u002F撤单，任意时刻不一定有挂单 |\n| **手续费** | 不区分主动\u002F被动成交 | 三区间定价：POC 区挂 Maker 单（省 ~0.03%）、GTC 区特许吃单锁定超额利润、熔断区拒绝下单 |\n| **建仓时机** | 进区间立即开仓 | 追踪建仓：价格进区间先追低点，确认反弹后才建仓，避免一开仓就站在高位被套 |\n| **止损** | 单一价位一次性平仓 | 分层算法单缓冲减仓，短暂跌破又反弹时残余仓位直接受益，省去重建手续费 |\n| **行情适应** | 固定单一区间 | 多段不重叠区间，价格进入哪段就激活哪段，其余休眠 |\n\n1. **先观察后决策的盯盘思维**：系统每次收到行情才判断当前价与目标价的关系——条件不利就停手观望，条件有利才在最优价卡位，价格大幅跳跃时还能捕获超出网格步长的额外价差。\n2. **Maker 优先 \u002F Taker 特许 \u002F 不利熔断**：默认挂 Post-Only Maker 单吃更低费率；只有当额外利润盖过吃单成本、机会稍纵即逝时才主动吃单；当前价比目标买价更贵时直接拒单，避免高买低卖。\n3. **追踪建仓**：避免顶部开仓被套。\n4. **分层算法单止损**：保留反弹恢复能力。\n5. **多段价格区间**：价格去哪里，策略就跟到哪里。\n\n> 逐项对比交易所网格的创新全解见 [`docs\u002FINNOVATIONS.md`](docs\u002FINNOVATIONS.md)；完整策略原理见 [`docs\u002FSTRATEGY_SPEC.md`](docs\u002FSTRATEGY_SPEC.md)。\n\n## ✨ 功能概览\n\n- **多段价格区间**：预配置多个不重叠区间（如 2000–2600、2600–3200），价格进哪段激活哪段\n- **追踪建仓**：追踪低点确认反弹后才建仓\n- **三区间动态定价**：POC 区 Maker、GTC 区锁超额利润、熔断区拒单\n- **分层止损缓冲**：主网格下方多档算法条件单分层减仓\n- **实时 WebSocket 推送**：Ticker \u002F 成交 \u002F 状态机事件实时同步前端\n- **多交易所支持**：统一适配器接口，兼容 Binance、Gate.io、OKX\n- **多语言界面**：内置 12 种语言\n\n## 💰 看懂手续费，注册时用邀请码省钱（赞助商 rebateto.me）\n\n手续费由交易所收取，**GridPilot 一分不抽**。同一笔交易，挂单（Maker）≈0.02%、吃单（Taker）≈0.05%。在杠杆与高频网格下，手续费会被悄悄放大，日积月累并不小——GridPilot 默认替你挂 Maker 单，每笔约省 0.03%，只有机会稍纵即逝时才主动吃单。\n\n更进一步：**注册交易所时填一个返佣码，就能把已付手续费长期返还约 20%（Gate 40%），自动到账**——相当于给每笔交易再打个折。\n\n> ⚠️ 每个交易所只能注册一次，返佣只能在注册时绑定，**老账户无法补——这是唯一的机会**。\n\n**赞助商 [rebateto.me](https:\u002F\u002Frebateto.me)** 汇总并维护各交易所的返佣注册入口。注册时请使用邀请码：\n\n| 交易所 | 邀请码 | 返佣比例 |\n|--------|--------|----------|\n| Binance | `fanwo20` | 20% |\n| OKX | `fangeiwo` | 20% |\n| Gate.io | `fangeiwo` | 40% |\n\n> 用 App 注册时记得手动填邀请码——漏填就拿不到返还。每个身份证每所限开一个账户。\n\n## 📦 安装\n\n**前置依赖**：Node.js ≥ 20、pnpm ≥ 9、Docker\n\n### 方式一：Docker 一键全栈（推荐自部署）\n\n```bash\ngit clone \u003Crepo-url> && cd grid-pilot\ncp .env.example .env\n# 生成加密密钥并填入 .env 的 ENCRYPTION_KEY\nopenssl rand -base64 32\n# 一键起 PostgreSQL + Redis + API + Web（自动执行数据库迁移）\ndocker compose --profile full up --build -d\n```\n\n启动后访问 http:\u002F\u002Flocalhost:3300 。\n\n> 不带 `--profile full` 时，`docker compose up` 只启动 PostgreSQL + Redis 基础设施，供本地开发使用。\n\n### 方式二：本地安装（推荐开发）\n\n```bash\ngit clone \u003Crepo-url> && cd grid-pilot\npnpm install\ncp .env.example .env        # 按需调整端口\u002F密钥\npnpm dev                    # 先起 docker 基础设施，再起 API + Web\n```\n\n| 服务 | 地址 | 配置项 |\n|------|------|--------|\n| 前端 | http:\u002F\u002Flocalhost:3300 | `WEB_PORT` \u002F `WEB_HOST` |\n| 后端 API | http:\u002F\u002Flocalhost:3301 | `API_PORT` \u002F `API_HOST` |\n| PostgreSQL | localhost:25432 | `DB_PORT` |\n| Redis | localhost:26379 | `REDIS_PORT` |\n\n单独启动：\n\n```bash\npnpm dev:infra        # 仅 PostgreSQL + Redis\npnpm dev:api          # 仅后端\npnpm dev:web          # 仅前端\npnpm dev:skip-infra   # API + Web，跳过 docker\n```\n\n## 🕹️ 使用说明\n\n1. **连接交易所**：在设置中填入 API Key\u002FSecret。**仅授予合约交易权限，切勿开启提现权限。**\n2. **配置网格**：选择交易对与价格区间，设置主网格格数、步长、每格数量、杠杆、止损缓冲、追踪建仓参数。\n3. **启动机器人**：进入追踪建仓 → 运行，前端实时显示行情、挂单、成交与状态机。\n4. **监控与收尾**：触发止盈端停止加仓收尾；触发止损缓冲分层减仓。\n\n关键参数：\n\n| 参数 | 说明 |\n|------|------|\n| `takeProfitPrice` | 止盈价（箱体止盈端边界） |\n| `mainGridCount` \u002F `mainGridStep` | 主网格格数 \u002F 每格步长（USDT） |\n| `mainGridPortionSize` | 每格下单数量 |\n| `leverage` | 杠杆倍数 |\n| `stopLossGridCount` \u002F `stopLossGridStep` | 止损缓冲区格数 \u002F 步长 |\n| `activationPrice` \u002F `trailingCallbackRate` | 追踪建仓激活价 \u002F 回调幅度 |\n| `excessProfitMultiplier` | GTC 区触发倍数（超额利润阈值） |\n\n完整参数见 [`docs\u002FSTRATEGY_SPEC.md`](docs\u002FSTRATEGY_SPEC.md)。\n\n## ⚠️ 注意事项\n\n- **风险免责**：合约交易具有高杠杆、高风险，可能导致全部本金损失。本项目为开源交易工具，**不构成任何投资建议**，不对盈亏负责。请先用小资金或交易所测试网充分验证。\n- **API 权限**：只开合约交易权限，**不要**开启提现权限。\n- **单 runner 约束**：同一交易所账户的同一交易对，同一时间只能运行一个机器人。\n- **返佣时机**：邀请码只能在注册时绑定，老账户无法补填。\n- **密钥安全**：`ENCRYPTION_KEY` 用于加密交易所凭证，务必使用随机生成的强密钥并妥善保管。\n- **端口冲突**：本地 3300\u002F3301 端口若被 `pnpm dev` 占用，会与 Docker 全栈容器冲突，请先停止本地进程再启动容器，或修改 `.env` 中的端口配置。\n\n## 🏗️ 技术栈与架构\n\n| 层级 | 技术 |\n|------|------|\n| 前端 | Next.js 16 · React 19 · Tailwind CSS v4 · Zustand · React Query · Recharts |\n| 后端 | NestJS 10 · Prisma 5 · BullMQ · Socket.IO |\n| 基础设施 | PostgreSQL 16 · Redis 7 · Docker Compose |\n| 共享 | TypeScript · pnpm Workspaces · Turborepo |\n\n```\napps\u002Fweb\u002F          # Next.js 前端（暗色主题，12 语）\napps\u002Fapi\u002F          # NestJS 后端\npackages\u002Fshared-types\u002F  # 前后端共享类型\ndocs\u002F              # STRATEGY_SPEC.md（策略规格）· ARCHITECTURE.md（组件映射）\ndocker-compose.yml # 默认基础设施；--profile full 全栈\n```\n\n**策略状态机**：`TRAILING_ENTRY → RUNNING → LIQUIDATING → LIQUIDATED`，`RUNNING` 可分支至 `TAKE_PROFIT`；运维分支含 `PAUSED`（可 `USER_RESUME` 复位）、`CANCELLED`、`HOLD`。\n\n**开发命令**：\n\n```bash\npnpm dev          # 一键起所有服务\npnpm build        # 构建\npnpm test         # 测试\npnpm lint         # Lint\n```\n\n**数据库**（本地开发）：\n\n```bash\ncd apps\u002Fapi\npnpm prisma migrate dev    # 执行迁移\npnpm prisma studio         # 查看数据\n```\n\n## 文档索引\n\n| 文档 | 说明 |\n|------|------|\n| [`docs\u002FINNOVATIONS.md`](docs\u002FINNOVATIONS.md) | 核心创新全解（逐项对比交易所原生网格） |\n| [`docs\u002FSTRATEGY_SPEC.md`](docs\u002FSTRATEGY_SPEC.md) | 完整策略规格说明书（权威参考） |\n| [`docs\u002FARCHITECTURE.md`](docs\u002FARCHITECTURE.md) | 代码组件到规格章节的映射索引 |\n| [`docs\u002Ffees-and-funding.md`](docs\u002Ffees-and-funding.md) | 手续费与资金费说明 |\n","GridPilot 是一款面向加密货币永续合约的动态网格交易系统，通过程序化模拟人工盯盘逻辑，实现比交易所原生网格更智能的实时决策。核心功能包括：动态改单与撤单（非静态挂单）、追踪建仓避免高位开仓、Maker优先定价节省手续费、分层算法单止损缓冲回撤、多段自适应价格区间切换。技术上基于 TypeScript 构建，支持 Binance\u002FOKX\u002FGate.io 三大交易所，内置 WebSocket 实时行情同步与 12 种语言界面。适用于震荡行情下的 ETH\u002FUSDT 等主流合约品种高频波段操作，尤其适合希望精细化控制风险、优化成交成本的专业量化交易者。",2,"2026-07-09 02:30:25","CREATED_QUERY"]