ETH/USDT 永续合约动态网格交易平台 · 兼容 Binance / Gate.io / OKX 像盯盘交易员一样实时决策，而非把单子挂上去就不管。
简体中文 · 繁體中文 · English · 日本語 · Español · العربية · Français · Português · Italiano · 한국어 · ไทย · Tiếng Việt
| 仪表盘 · 总览 | 费用与返佣 |
|---|---|
 |
 |
深青色品牌主题 · Space Grotesk / IBM Plex 字体 · 内置 12 种语言，界面随语言切换。
网格交易把一段价格区间切成若干"网格线"，价格每跌一格就买、每涨一格就卖——在震荡行情里反复高抛低吸，把波动本身变成收益。它不预测涨跌，只赚区间内来回波动的差价，因此特别适合无明确趋势、上下震荡的市场。
与"买入持有"相比：买入持有只在最终上涨时获利；网格在横盘震荡中持续积累一笔笔小利润。代价是需要持续管理订单、控制风险——这正是 GridPilot 要替你自动化的部分。
⚠️ 网格交易并非稳赚：单边下跌时仍会浮亏，杠杆会放大风险。请先理解策略再投入。
交易所自带的网格机器人，本质是"一次性批量挂单、挂上不动、等市场来撞单"。GridPilot 的核心差异是用程序模拟一个有经验的盯盘交易员：
| 维度 | 交易所原生网格 | GridPilot |
|---|---|---|
| 下单方式 | 批量静态挂单，挂出后不再移动 | 自动化盯盘：每次行情更新都重新判断后才动态下单/改单/撤单，任意时刻不一定有挂单 |
| 手续费 | 不区分主动/被动成交 | 三区间定价：POC 区挂 Maker 单（省 ~0.03%）、GTC 区特许吃单锁定超额利润、熔断区拒绝下单 |
| 建仓时机 | 进区间立即开仓 | 追踪建仓：价格进区间先追低点，确认反弹后才建仓，避免一开仓就站在高位被套 |
| 止损 | 单一价位一次性平仓 | 分层算法单缓冲减仓，短暂跌破又反弹时残余仓位直接受益，省去重建手续费 |
| 行情适应 | 固定单一区间 | 多段不重叠区间，价格进入哪段就激活哪段，其余休眠 |
- 先观察后决策的盯盘思维：系统每次收到行情才判断当前价与目标价的关系——条件不利就停手观望，条件有利才在最优价卡位，价格大幅跳跃时还能捕获超出网格步长的额外价差。
- Maker 优先 / Taker 特许 / 不利熔断：默认挂 Post-Only Maker 单吃更低费率；只有当额外利润盖过吃单成本、机会稍纵即逝时才主动吃单；当前价比目标买价更贵时直接拒单，避免高买低卖。
- 追踪建仓：避免顶部开仓被套。
- 分层算法单止损：保留反弹恢复能力。
- 多段价格区间：价格去哪里，策略就跟到哪里。
逐项对比交易所网格的创新全解见
docs/INNOVATIONS.md；完整策略原理见docs/STRATEGY_SPEC.md。
- 多段价格区间：预配置多个不重叠区间（如 2000–2600、2600–3200），价格进哪段激活哪段
- 追踪建仓：追踪低点确认反弹后才建仓
- 三区间动态定价：POC 区 Maker、GTC 区锁超额利润、熔断区拒单
- 分层止损缓冲：主网格下方多档算法条件单分层减仓
- 实时 WebSocket 推送：Ticker / 成交 / 状态机事件实时同步前端
- 多交易所支持：统一适配器接口，兼容 Binance、Gate.io、OKX
- 多语言界面：内置 12 种语言
手续费由交易所收取，GridPilot 一分不抽。同一笔交易，挂单（Maker）≈0.02%、吃单（Taker）≈0.05%。在杠杆与高频网格下，手续费会被悄悄放大，日积月累并不小——GridPilot 默认替你挂 Maker 单，每笔约省 0.03%，只有机会稍纵即逝时才主动吃单。
更进一步：注册交易所时填一个返佣码，就能把已付手续费长期返还约 20%（Gate 40%），自动到账——相当于给每笔交易再打个折。
⚠️ 每个交易所只能注册一次，返佣只能在注册时绑定，老账户无法补——这是唯一的机会。
赞助商 rebateto.me 汇总并维护各交易所的返佣注册入口。注册时请使用邀请码：
| 交易所 | 邀请码 | 返佣比例 |
|---|---|---|
| Binance | fanwo20 |
20% |
| OKX | fangeiwo |
20% |
| Gate.io | fangeiwo |
40% |
用 App 注册时记得手动填邀请码——漏填就拿不到返还。每个身份证每所限开一个账户。
前置依赖：Node.js ≥ 20、pnpm ≥ 9、Docker
git clone <repo-url> && cd grid-pilot
cp .env.example .env
# 生成加密密钥并填入 .env 的 ENCRYPTION_KEY
openssl rand -base64 32
# 一键起 PostgreSQL + Redis + API + Web（自动执行数据库迁移）
docker compose --profile full up --build -d启动后访问 http://localhost:3300 。
不带
--profile full时，docker compose up只启动 PostgreSQL + Redis 基础设施，供本地开发使用。
git clone <repo-url> && cd grid-pilot
pnpm install
cp .env.example .env # 按需调整端口/密钥
pnpm dev # 先起 docker 基础设施，再起 API + Web| 服务 | 地址 | 配置项 |
|---|---|---|
| 前端 | http://localhost:3300 | WEB_PORT / WEB_HOST |
| 后端 API | http://localhost:3301 | API_PORT / API_HOST |
| PostgreSQL | localhost:25432 | DB_PORT |
| Redis | localhost:26379 | REDIS_PORT |
单独启动：
pnpm dev:infra # 仅 PostgreSQL + Redis
pnpm dev:api # 仅后端
pnpm dev:web # 仅前端
pnpm dev:skip-infra # API + Web，跳过 docker- 连接交易所：在设置中填入 API Key/Secret。仅授予合约交易权限，切勿开启提现权限。
- 配置网格：选择交易对与价格区间，设置主网格格数、步长、每格数量、杠杆、止损缓冲、追踪建仓参数。
- 启动机器人：进入追踪建仓 → 运行，前端实时显示行情、挂单、成交与状态机。
- 监控与收尾：触发止盈端停止加仓收尾；触发止损缓冲分层减仓。
关键参数：
| 参数 | 说明 |
|---|---|
takeProfitPrice |
止盈价（箱体止盈端边界） |
mainGridCount / mainGridStep |
主网格格数 / 每格步长（USDT） |
mainGridPortionSize |
每格下单数量 |
leverage |
杠杆倍数 |
stopLossGridCount / stopLossGridStep |
止损缓冲区格数 / 步长 |
activationPrice / trailingCallbackRate |
追踪建仓激活价 / 回调幅度 |
excessProfitMultiplier |
GTC 区触发倍数（超额利润阈值） |
完整参数见 docs/STRATEGY_SPEC.md。
- 风险免责：合约交易具有高杠杆、高风险，可能导致全部本金损失。本项目为开源交易工具，不构成任何投资建议，不对盈亏负责。请先用小资金或交易所测试网充分验证。
- API 权限：只开合约交易权限，不要开启提现权限。
- 单 runner 约束：同一交易所账户的同一交易对，同一时间只能运行一个机器人。
- 返佣时机：邀请码只能在注册时绑定，老账户无法补填。
- 密钥安全：
ENCRYPTION_KEY用于加密交易所凭证，务必使用随机生成的强密钥并妥善保管。 - 端口冲突：本地 3300/3301 端口若被
pnpm dev占用，会与 Docker 全栈容器冲突，请先停止本地进程再启动容器，或修改.env中的端口配置。
| 层级 | 技术 |
|---|---|
| 前端 | Next.js 16 · React 19 · Tailwind CSS v4 · Zustand · React Query · Recharts |
| 后端 | NestJS 10 · Prisma 5 · BullMQ · Socket.IO |
| 基础设施 | PostgreSQL 16 · Redis 7 · Docker Compose |
| 共享 | TypeScript · pnpm Workspaces · Turborepo |
apps/web/ # Next.js 前端（暗色主题，12 语）
apps/api/ # NestJS 后端
packages/shared-types/ # 前后端共享类型
docs/ # STRATEGY_SPEC.md（策略规格）· ARCHITECTURE.md（组件映射）
docker-compose.yml # 默认基础设施；--profile full 全栈
策略状态机：TRAILING_ENTRY → RUNNING → LIQUIDATING → LIQUIDATED，RUNNING 可分支至 TAKE_PROFIT；运维分支含 PAUSED（可 USER_RESUME 复位）、CANCELLED、HOLD。
开发命令：
pnpm dev # 一键起所有服务
pnpm build # 构建
pnpm test # 测试
pnpm lint # Lint数据库（本地开发）：
cd apps/api
pnpm prisma migrate dev # 执行迁移
pnpm prisma studio # 查看数据| 文档 | 说明 |
|---|---|
docs/INNOVATIONS.md |
核心创新全解（逐项对比交易所原生网格） |
docs/STRATEGY_SPEC.md |
完整策略规格说明书（权威参考） |
docs/ARCHITECTURE.md |
代码组件到规格章节的映射索引 |
docs/fees-and-funding.md |
手续费与资金费说明 |