Files
ritmex-bot/docs/standx/maker-points-guide.md
T

113 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# StandX 做市积分策略使用教程(新手版)
本教程用于帮助你快速上手 StandX 做市积分策略(Maker Points)。无需交易经验,照着步骤做即可。
---
## 1. 准备工作
### 1.1 安装 Bun
本项目使用 Bun 运行。
如果你还没有安装 Bun,请先参考官方文档完成安装:
- https://bun.sh/
安装完成后,进入项目目录执行:
```bash
bun install
```
### 1.2 获取 StandX 登录凭证(Token
策略需要 StandX 的登录 token 才能下单。
获取方式:
1. 打开 https://standx.ritmex.one/
2. 连接钱包
3. 点击“登录”
4. 导出登录信息(里面会包含 TOKEN 以及生成的代理钱包私钥)
请妥善保存,不要分享给他人。
---
## 2. 配置环境变量
在项目根目录新建 `.env` 文件(或修改已有 `.env`),填入以下配置:
```bash
EXCHANGE=standx
STANDX_REQUEST_PRIVATE_KEY=你的代理钱包私钥
STANDX_TOKEN=你的token
STANDX_SYMBOL=BTC-USD
MAKER_POINTS_ORDER_AMOUNT=0.01
MAKER_POINTS_CLOSE_THRESHOLD=0.1
MAKER_POINTS_STOP_LOSS_USD=0
MAKER_POINTS_MIN_REPRICE_BPS=3
MAKER_POINTS_BAND_0_10=true
MAKER_POINTS_BAND_10_30=true
MAKER_POINTS_BAND_30_100=true
```
### 配置说明(新手可直接照抄)
- `STANDX_TOKEN`: 登录后导出的 token(必须)
- `STANDX_SYMBOL`: 交易对(默认 `BTC-USD`
- `MAKER_POINTS_ORDER_AMOUNT`: 每一笔挂单数量
- `MAKER_POINTS_CLOSE_THRESHOLD`: 持仓达到该数值进入平仓模式(0 表示不自动平仓)
- `MAKER_POINTS_STOP_LOSS_USD`: 亏损超过该值时市价平仓(0 表示关闭)
- `MAKER_POINTS_MIN_REPRICE_BPS`: 盘口变动达到多少 bps 才会重算并撤单(默认 3)
- `MAKER_POINTS_BAND_0_10` / `10_30` / `30_100`: 三个档位开关
---
## 3. 启动策略
### 3.1 普通启动
```bash
bun run index.ts --strategy maker-points --exchange standx
```
### 3.2 使用 PM2 后台运行(推荐)
```bash
bun run pm2:start:maker-points
```
PM2 会自动重启策略,适合长期运行。
---
## 4. 运行后你会看到什么
启动后会显示仪表盘,包含:
- 当前交易对与盘口
- 当前仓位与浮动盈亏
- 目标挂单列表
- 已挂单列表
- Binance 深度失衡状态
---
## 5. 新手常见问题
### Q1:为什么会撤单重挂?
策略只有在盘口变化超过 `MAKER_POINTS_MIN_REPRICE_BPS` 或 Binance 深度状态变化时才会重算挂单。
### Q2:担心平掉手动持仓怎么办?
`MAKER_POINTS_CLOSE_THRESHOLD` 设为 0 或者设成大于你的持仓即可。
### Q3:我只想挂某个档位?
把不需要的档位开关设为 `false` 即可。
---
## 6. 注意事项
1. 请确保钱包里有足够的保证金/资金。
2. 不要泄露 `STANDX_TOKEN`
3. 初次使用请先用小仓位测试。
---
如果你需要我帮你定制参数或排查问题,直接把日志贴给我即可。