MCPcopy Index your code
hub / github.com/beibei030/grid-fleet

github.com/beibei030/grid-fleet @v2.0.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v2.0.0 ↗ · + Follow
1,053 symbols 2,745 edges 96 files 90 documented · 9%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Multi-Venue Neutral Grid Fleet

三所永续中性网格 + 总看板的开箱即用参考实现。策略参数、舰队维护、库存控制、看板聚合均与作者生产环境对齐;填好 API 凭证即可运行。

License: MIT

应用 交易所
apps/extended-grid Extended Node ESM,零依赖 HTTP + SSE 看板
apps/risex-grid RISEx Node ESM + 链上适配
apps/decibel-grid Decibel TypeScript + Aptos / Decibel SDK
apps/overview 聚合上列三所 TypeScript 只读总看板

环境要求Node.js ≥ 20(Decibel / Overview 使用 tsx

免责声明:本仓库为策略与控制面参考代码,不构成投资建议。实盘需自行承担风险,妥善保管 API 密钥与私钥。详见 SECURITY.md

界面预览(实盘截图)

Extended 网格看板 三所总看板
Extended 网格 网格总览

各交易所详情(总看板底部)

各交易所详情

来自作者 VPS 实盘运行界面(SSH 隧道本地截取,地址栏为 127.0.0.1,无公网 IP)。

文档

文档 内容
docs/OPEN_SOURCE.md 开源总览(表格):是什么/不是什么、参数对照、能力清单
docs/SETUP.md API 密钥怎么填(含 Decibel 逐步说明)、启动顺序
docs/STRATEGY.md 中性网格策略参数与维护逻辑
docs/PITFALLS.md 实盘踩坑与运维禁忌
docs/API.md HTTP API(snapshot / fleet 控制)
CHANGELOG.md 版本记录
CONTRIBUTING.md 贡献指南
SECURITY.md 安全与密钥规范

策略概要

  • 模式:中性网格(neutral),每所 3 槽 BTC / ETH / SOL
  • 区间:现价 ±2.4%rangeHalfPct=0.024
  • 格数:Extended 24 / RISEx 18 / Decibel 22
  • 杠杆:5x
  • 破区间:移框重挂(autoRecenter / shiftGrid),默认不平仓
  • 库存:净仓超 4×sizeBase 停同向加仓;reduce-only 覆盖约 70% 持仓
  • 偏少replenishIfEmpty 补格,因偏少整盘 recenter

快速开始

Mac / Linux(推荐)

git clone https://github.com/beibei030/grid-fleet.git
cd grid-fleet
chmod +x scripts/*.sh
./scripts/install-all.sh

cp apps/extended-grid/.env.example apps/extended-grid/.env
cp apps/risex-grid/.env.example apps/risex-grid/.env
cp apps/decibel-grid/.env.example apps/decibel-grid/.env
cp apps/overview/.env.example apps/overview/.env
# 编辑四个 .env,填入凭证与各 PORT / URL

./scripts/start-all.sh   # 或分别 scripts/start-extended.sh 等

手动逐进程

# 1. Extended
cd apps/extended-grid && cp .env.example .env && node server.js

# 2. RISEx
cd apps/risex-grid && cp .env.example .env && node server.js

# 3. Decibel
cd apps/decibel-grid && npm i && cp .env.example .env && npm run start

# 4. 总看板(三所都起来之后)
cd apps/overview && npm i && cp .env.example .env && npm run start

各所 PORT 自行在 .env 指定;总看板的 *_GRID_FLEET_URL 填对应本机地址。详细凭证获取与 Decibel 配置见 SETUP.md

架构

Overview(总看板)──HTTP──► Extended grid
                    ├──► RISEx grid
                    └──► Decibel grid

各所独立进程;共享策略思想,交易所适配器分别实现。

架构概览

相关 API 文档

  • Extended: https://api.docs.extended.exchange/
  • RISEx: https://developer.rise.trade/reference/integration
  • Decibel: https://docs.decibel.trade/typescript-sdk/write-sdk

License

MIT License — Copyright (c) 2026 beibei030

贡献

Issue / PR 欢迎。请勿在 PR 中包含 .env、私钥或真实账户地址。见 CONTRIBUTING.md

Extension points exported contracts — how you extend this code

ExchangeAdapter (Interface)
(no doc) [4 implementers]
apps/decibel-grid/src/exchanges/types.ts
VenueSnap (Interface)
(no doc)
apps/overview/src/core/overviewTelegram.ts
Exchanges (Interface)
(no doc)
apps/decibel-grid/src/exchanges/index.ts
Baseline (Interface)
(no doc)
apps/overview/src/core/overviewTelegram.ts
MarketCfg (Interface)
(no doc)
apps/decibel-grid/src/exchanges/decibelExchange.ts
PersistedState (Interface)
(no doc)
apps/overview/src/core/overviewTelegram.ts
PaperPos (Interface)
(no doc)
apps/decibel-grid/src/exchanges/paperExchange.ts
VenueLedgerView (Interface)
(no doc)
apps/overview/src/core/overviewLedger.ts

Core symbols most depended-on inside this repo

num
called by 113
apps/decibel-grid/src/config.ts
num
called by 113
apps/overview/src/config.ts
str
called by 67
apps/decibel-grid/src/config.ts
str
called by 67
apps/overview/src/config.ts
send
called by 42
apps/risex-grid/server.js
send
called by 40
apps/extended-grid/server.js
round2
called by 37
apps/overview/src/core/overviewLedger.ts
round2
called by 32
apps/decibel-grid/src/core/overviewLedger.ts

Shape

Function 493
Method 452
Interface 67
Class 41

Languages

TypeScript100%

Modules by API surface

apps/extended-grid/exchange/extended.js51 symbols
apps/risex-grid/risex.js49 symbols
apps/risex-grid/exchange/risex.js49 symbols
apps/risex-grid/bot.js46 symbols
apps/extended-grid/bot.js42 symbols
apps/decibel-grid/src/exchanges/decibelExchange.ts40 symbols
apps/decibel-grid/src/grid/exchanges/decGridExchange.ts32 symbols
apps/decibel-grid/src/grid/gridBot.ts31 symbols
apps/overview/src/core/overviewLedger.ts28 symbols
apps/decibel-grid/src/grid/gridManager.ts27 symbols
apps/decibel-grid/src/core/overviewLedger.ts27 symbols
apps/extended-grid/exchange/starkcrypto.js26 symbols

For agents

$ claude mcp add grid-fleet \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact