andyboss1995/ritmex-bot

选用指南

AI 根据 README 整理 · 2026/11/5 17:26:55

使用方式

通过命令行启动，支持交互式菜单或静默模式直接指定策略和交易所。

查看 README 依据

cp .env.example .env ``` 按下文指南修改 `.env`，至少需要正确配置一个交易所的凭证。 5. **运行 CLI** ```bash bun run index.ts ``` 方向键选择策略并回车启动；`Esc` 返回菜单，`Ctrl+C` 退出。 ## 通用环境变量 `.env.example` 提供了所有默认键值，下表概括最常用参数： | 变量 | 说明 | | --- | --- | | `EXCHANGE` | 选择交易所（`aster`/`standx`/`grvt`/`lighter`/`backpack`/`paradex`/`nado`） | | `TRADE_SYMBOL` | 交易对（默认 `BTCUSDT`） | | `TRADE_AMOUNT` | 单笔下单数量（标的资产计） | | `LOSS_LIMIT` | 单笔最大亏损触发的强平额度（USDT） | | `TRAILING_PROFIT` / `TRAILING_CALLBACK_RATE` | 动态止盈触发值（USDT）与回撤百分比 | | `PROFIT_LOCK_TRIGGER_USD` / `PROFIT_LOCK_OFFSET_USD` | 浮盈超过阈值后上调止损的触发金额与偏移 |

2. 在 Nado 官网（交易界面）打开开发者工具（F12）→ 切换到 `Application` → `Local Storage`，找到 `nado.userSettings`，在其内容中取出 `privateKey` 字段并填入 `.env` 的 `NADO_SIGNER_PRIVATE_KEY`。 3. 提供 `NADO_SUBACCOUNT_OWNER`（或 `NADO_EVM_ADDRESS`）。 4. 选择网络 `NADO_ENV=inkMainnet`（主网）或 `inkTestnet`（测试网）。 5. 设置交易品种 `NADO_SYMBOL`（交易对格式类似 `BTC-PERP`；也支持输入 `BTCUSDT0`，会自动映射为 `BTC-PERP`）。 ## 命令速查 ```bash bun run index.ts # 启动 CLI（默认入口） bun run start # 等价于运行 index.ts bun run dev # 调试模式 bun x vitest run # 执行全部测试 ``` ## 静默启动与后台运行 ### 直接静默启动 无需进入 Ink 菜单，可用命令行直接拉起指定策略： ```bash bun run index.ts --strategy trend --silent

部署要求

需要 Bun ≥ 1.2，支持 macOS、Linux 或 Windows（推荐 WSL），至少配置一个交易所的 API 凭证。

查看 README 依据

| Lighter | zkLighter 永续 | `LIGHTER_ACCOUNT_INDEX`, `LIGHTER_API_PRIVATE_KEY` | 默认 `LIGHTER_ENV=testnet` | Backpack | USDC 永续 | `BACKPACK_API_KEY`, `BACKPACK_API_SECRET`, `BACKPACK_PASSWORD` | `BACKPACK_SANDBOX=true` 启用沙盒 | Paradex | StarkEx 永续 | `PARADEX_PRIVATE_KEY`, `PARADEX_WALLET_ADDRESS` | `PARADEX_SANDBOX=true` 使用测试网 | Nado | USDC 永续 | `NADO_SIGNER_PRIVATE_KEY`, `NADO_SUBACCOUNT_OWNER` | `NADO_ENV` 可切换 `inkMainnet`/`inkTestnet` ## 系统要求 - Bun ≥ 1.2（需同时包含 `bun`、`bunx` 命令） - macOS、Linux 或 Windows (推荐 WSL) - Node.js 仅在部分工具链场景需要，可选 ## 快速上手 ### 一键脚本（macOS / Linux / WSL） ```bash

cp .env.example .env ``` 按下文指南修改 `.env`，至少需要正确配置一个交易所的凭证。 5. **运行 CLI** ```bash bun run index.ts ``` 方向键选择策略并回车启动；`Esc` 返回菜单，`Ctrl+C` 退出。 ## 通用环境变量 `.env.example` 提供了所有默认键值，下表概括最常用参数： | 变量 | 说明 | | --- | --- | | `EXCHANGE` | 选择交易所（`aster`/`standx`/`grvt`/`lighter`/`backpack`/`paradex`/`nado`） | | `TRADE_SYMBOL` | 交易对（默认 `BTCUSDT`） | | `TRADE_AMOUNT` | 单笔下单数量（标的资产计） | | `LOSS_LIMIT` | 单笔最大亏损触发的强平额度（USDT） | | `TRAILING_PROFIT` / `TRAILING_CALLBACK_RATE` | 动态止盈触发值（USDT）与回撤百分比 | | `PROFIT_LOCK_TRIGGER_USD` / `PROFIT_LOCK_OFFSET_USD` | 浮盈超过阈值后上调止损的触发金额与偏移 |

已知限制

作者建议至少准备50-100 USDT资金，并需手动在交易所设置杠杆和单向持仓模式。

查看 README 依据

bun run test bun x vitest --watch ``` ## 常见问题 - 至少准备 50–100 USDT 资金以覆盖策略运行需求。 - 杠杆需在交易所提前设置（建议 ~50 倍），程序不会自动调整。 - 请确保服务器/电脑时间同步真实世界时间，避免签名过期。 - 账户需保持单向持仓模式。 - `.env` 未读取：确认文件位于项目根目录且变量名无误。 - API 拒绝访问：检查交易所后台权限，确保开启合约读写。 - 精度错误：同步交易对的最小价格与数量步长。 更多排查细节可参见 [简明上手指南](simple-readme.md)。 ## 社区与支持 - Telegram 交流群：[https://t.me/+4fdo0quY87o4Mjhh](https://t.me/+4fdo0quY87o4Mjhh) - 欢迎通过 Issue 或 PR 提交反馈、特性建议 ## 风险提示 量化交易具备风险。请先在仿真或小额账户中验证策略表现，妥善保管 API 密钥，仅开启必要权限。