From de13142950b0121dbabbc06a081599af8db6616f Mon Sep 17 00:00:00 2001
From: discountry <feibilanceon@gmail.com>
Date: Tue, 6 Jan 2026 20:08:38 +0800
Subject: [PATCH] Add StandX Maker Points strategy tutorial and update README
 with configuration details. Include steps for obtaining login token and
 environment variable setup for new users, enhancing documentation clarity and
 usability.

---
 README.md                         |  20 +++++-
 docs/standx/maker-points-guide.md | 112 ++++++++++++++++++++++++++++++
 2 files changed, 129 insertions(+), 3 deletions(-)
 create mode 100644 docs/standx/maker-points-guide.md

diff --git a/README.md b/README.md
index c619eaa..cf4feb9 100644
--- a/README.md
+++ b/README.md
@@ -111,11 +111,25 @@ curl -fsSL https://github.com/discountry/ritmex-bot/raw/refs/heads/main/setup.sh
 4. 一键脚本会自动写入这些变量，手动部署时需自行维护。
 
 ### StandX
+
+* [StandX 做市策略教程](docs/standx/maker-points-guide.md)
+
+策略需要 StandX 的登录 token 才能下单
+
+获取方式：
+1. 打开 https://standx.ritmex.one/
+2. 连接钱包
+3. 点击“登录”
+4. 导出登录信息里面会包含 token和代理钱包私钥，代理钱包仅用于交易签名，有效保证资产钱包安全
+
+请妥善保存，不要分享给他人
+
 1. 设置 `EXCHANGE=standx`。
 2. 填写 `STANDX_TOKEN`（Perps API 的 JWT Token）。
-3. 设置 `STANDX_SYMBOL`（默认 `BTC-USD`），并校准 `PRICE_TICK` / `QTY_STEP`。
-4. 可选：`STANDX_BASE_URL`、`STANDX_WS_URL`、`STANDX_SESSION_ID` 用于自定义环境。
-5. 可选：如需请求签名，补充 `STANDX_REQUEST_PRIVATE_KEY`。
+3. 填写 `STANDX_REQUEST_PRIVATE_KEY`（代理钱包私钥）。
+4. 设置 `STANDX_SYMBOL`（默认 `BTC-USD`），并校准 `PRICE_TICK` / `QTY_STEP`。
+5. 可选：`STANDX_BASE_URL`、`STANDX_WS_URL`、`STANDX_SESSION_ID` 用于自定义环境。
+
 
 ### GRVT
 1. 在 `.env` 中设置 `EXCHANGE=grvt`。
diff --git a/docs/standx/maker-points-guide.md b/docs/standx/maker-points-guide.md
new file mode 100644
index 0000000..826ea53
--- /dev/null
+++ b/docs/standx/maker-points-guide.md
@@ -0,0 +1,112 @@
+# 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. 初次使用请先用小仓位测试。
+
+---
+
+如果你需要我帮你定制参数或排查问题，直接把日志贴给我即可。