从开户到自动交易
一份手册走完全流程

最快开通路径

按下面顺序完成一次配置，通常 10 到 30 分钟即可进入自动交易。任何一步测试失败，都先停在当前步骤处理，不要直接投入大额资金。

开始前的资金与风险准备

本系统交易的是 3S、5S 等杠杆型空头 ETF。它们会受标的涨跌、波动衰减、份额合并和停牌影响，不适合把全部资产投入。建议使用独立交易账户和可承受损失的资金。

2.1 账户准备

• 注册并登录 Gate.io，完成 KYC 身份认证。
• 为自动交易准备独立账户，只保留策略需要的 USDT。
• 确认账户可以交易目标现货市场和永续合约。
• 不要向任何人提供 Gate.io 登录密码、资金密码、2FA 验证码或 API Secret。

2.2 资金准备

• 资金总额必须高于首次买入和全部计划加仓金额之和。
• 额外预留手续费、滑点和价格波动空间，避免余额不足导致后续加仓失败。
• 第一次使用时建议把首次买入金额和加仓金额设为小额，确认流程后再调整。

Gate.io API 创建与权限

系统不保存 Gate.io 登录密码，只通过用户自己的 API Key 读取余额和执行交易。每个主账号和子账号使用各自的 API Key，策略和持仓互不混用。

3.1 创建 API Key

1. 登录 Gate.io，打开头像菜单中的 API 管理。
2. 创建 API v4 Key，账户类型选择经典账户。
3. 备注名称填写便于识别的名称，例如 L5B 量化交易。
4. 按下方权限表设置读写范围，并完成资金密码和 2FA 验证。

3.2 绑定 IP 白名单

在 Gate.io API 设置中将服务器出口 IP 206.187.209.107 加入白名单。未绑定白名单时，服务器可能无法读取余额或下单。若管理员已经迁移服务器，请以管理员公布的新出口 IP 为准。

登录 Web、EXE 与 Android

4.1 Web 端

1. 打开 https://www.l5b.cn/trade/。
2. 输入管理员分配的用户名和密码。
3. 首次登录后进入账户设置或个人中心修改初始密码。
4. 从左侧菜单进入使用说明、账户资料、策略参数、交易所接口和推送配置。

4.2 Windows EXE

双击已安装的 L5B 量化交易终端，输入同一套账号。顶部可以切换主账户合并视图或子账户视图；左下角“使用说明”打开操作手册；账户设置中的“推送通知”可以独立管理 Telegram、Bark 和事件开关。

4.3 Android App

安装 APK 后打开应用，使用同一套账号登录。首页展示资产、收益、持仓和系统状态；“我的”页面提供使用说明、策略参数、交易所接口、推送配置和后台保护入口。

4.4 登录异常

• 提示密码错误：确认用户名没有空格，并核对大小写。
• 提示账号禁用或授权过期：联系管理员检查账号状态和授权时间。
• 提示无法连接服务器：稍后重试；EXE 和 Android 客户端会自动切换 IP 备用通道。

配置并检测交易所接口

进入“交易所接口”或“API Key”页面，填写 API Key 与 Secret。保存后系统只显示掩码，不会再次回显完整密钥。

1. 粘贴新的 API Key 和 API Secret。
2. 点击保存。保存会替换当前账户原有的接口配置。
3. 点击测试连接与权限。
4. 确认连通性、现货读取和现货交易通过；合约权限按账户实际能力检查。
5. 提现权限一项应显示为“建议关闭”。

策略参数详解

策略参数控制候选、首次买入、加仓、止盈、移动止损、仓位和滑点。修改后立即写入当前账户配置，但不会重写已有持仓的历史成本。

6.1 参数冲突检查

• 首次买入金额加全部加仓金额不能超过账户可用资金。
• 固定止盈比例应大于 0 且不超过 1。
• 最大持仓数应小于或等于账户资金可分散承担的币种数量。
• 滑点阈值过低可能导致频繁拒绝，过高可能放大成交成本。
• 黑名单应包含流动性差、长期停牌或不愿持有的标的。

自动交易如何执行

1. 共享扫描器读取 3S、5S 标的与 UTC 日开盘价
2. 候选进入深跌和反弹确认
3. 每个用户 Worker 读取自己的策略与 API Key
4. 余额、滑点、熔断和紧急停止检查
5. 首次买入或按序列加仓
6. 固定止盈、移动止损或持有到期卖出
7. 写入交易流水并发送 Telegram / Bark

7.1 触发与等待

• 跌幅刚达到首次触发线时只会进入候选，不代表马上买入。
• 深跌、反弹幅度和持续时间同时满足后，Worker 才会提交首买。
• 后续加仓使用上次加仓价和加仓跌幅重新计算。
• 紧急停止开启时拒绝买入，但仍允许卖出和平仓。

7.2 止盈与退出

• 固定止盈先卖出一部分仓位，剩余仓位继续跟踪。
• 移动止损线根据历史最高盈利和峰值利润回吐比例计算。
• 持有超过最大天数后，系统按换仓处理。
• 用户手动从交易所卖出的部分，会在同步时识别并写入平仓记录。

每天查看哪些页面

8.1 状态判断

• 引擎在线且交易所正常：策略可以继续运行。
• 引擎在线但交易所异常：检查 API Key、IP 白名单和交易所网络。
• 没有新买入但引擎正常：先检查候选条件、黑名单、余额和紧急停止状态。
• 数据长时间不更新：刷新页面，再检查账户缓存与 Worker 告警。

手动平仓与外部交易

手动平仓用于提前退出某个持仓。系统会异步提交任务，先返回“已提交服务器处理，请等待推送通知”，随后由后台线程读取交易所可用余额并执行市价卖出。

1. 进入当前持仓，打开目标币种详情。
2. 核对账户、数量、成本、当前价格和预计盈亏。
3. 点击平仓并完成二次确认。
4. 页面提示已提交后不要连续重复点击。
5. 等待 Telegram、Bark 或操作日志返回最终结果。

9.1 在 Gate.io 手动操作后

系统会在后续同步周期识别外部买入、部分卖出、完全卖出和份额合并。完成外部操作后不要立即在客户端重复录入持仓，等待同步并查看操作日志。

Telegram 与 Bark 推送

推送用于接收买入、加仓、卖出、手动平仓、告警、日报和更新通知。Web、Windows EXE 和 Android 客户端均可在推送配置中管理。

10.1 Telegram

1. 打开系统推送配置，查看管理员配置的机器人用户名。
2. 点击机器人链接，在 Telegram 中发送 /start。
3. 复制机器人返回的数字 Telegram User ID。
4. 粘贴 User ID 并保存，开启 Telegram 推送。
5. 点击测试 Telegram，确认收到测试消息。

10.2 Bark

1. 在 iPhone 的 App Store 安装 Bark。
2. 打开 Bark，复制设备 Key。
3. 在推送配置中填写 Bark Server 和 Key。
4. 开启 Bark 推送并保存，再点击测试 Bark。

10.3 事件开关

主账户与子账户

一个主账户最多创建 10 个子账户。每个子账户是独立交易账户，拥有自己的 API Key、持仓、平仓历史和推送设置。四项核心策略参数由主账户统一控制。

• 切换器位置：Web 顶部账号区域、EXE 顶部账户下拉框、Android 顶部账户标签。
• Web、Windows EXE 和 Android 都可以新建子账户；EXE 在“多账户视图”右上角创建，Android 在账户切换面板中创建。
• 子账户的授权时间继承主账户；主账户授权过期后子账户也会停止交易。
• 主账户保存时，只有首次触发、止盈激活、峰值利润回吐和加仓触发中实际发生变化的分项，才会向所有子账户重新生成 1–3 个百分点随机偏移；保存其他参数不会改动现有子账户偏移。
• 随机结果会保存到子账户并限制在 0%–100%；子账户页面显示主账户基准值和本次偏移，不能单独修改这四项。
• 新建子账户时会立即从主账户当前四项参数生成独立的随机偏移值。
• 在子账户视角下不能继续创建新的子账户。
• 平仓前确认当前账户，避免对错误账户执行操作。

授权续期与账号安全

12.1 授权续期

1. 登录后查看首页、侧边栏或账户中心的授权到期时间。
2. 收到即将到期提醒时，向管理员获取授权码。
3. 在续期弹窗输入授权码并提交。
4. 续期成功后授权时间自动延长，无需重新配置 API Key。

授权到期后买入会暂停，但卖出和手动平仓仍可使用。仍无法进入系统时，请联系管理员检查授权码是否有效、是否达到使用次数上限。

12.2 安全习惯

• 首次登录后立即修改初始密码。
• 使用与其他平台不同的强密码，不向任何人提供验证码。
• API Key 只开启交易所需权限，永久关闭提现权限。
• 定期检查 API Key 的 IP 白名单和最近测试结果。
• 发现异常登录、异常持仓或陌生推送时，立即关闭紧急买入并联系管理员。

三端功能对照

13.1 Windows EXE

• 启动后优先连接 www.l5b.cn；域名解析或连接失败时自动切换服务器 IP，HTTPS 证书校验保持开启。
• 账户设置新增推送通知页，可配置 Telegram、Bark 和事件开关并直接测试。
• 侧边栏“使用说明”可离线查看完整操作步骤。

13.2 Android

• 首次安装建议允许通知、忽略电池优化，并按厂商系统要求允许自启动。
• 后台交易事件使用前台服务监听，系统清理后由 WorkManager 约 15 分钟兜底。
• “我的”页面可打开原生使用说明和推送配置。

13.3 客户端热更新

1. 管理员在管理后台“客户端更新”中分别上传 Windows ZIP 或 Android APK，并填写版本号、更新说明和最低兼容版本。
2. Windows 客户端每次启动后都会自动检查版本，发现新版立即弹窗；点击下载后任务会在后台继续，可自由切换页面。下载并校验完成后会弹窗提示重启，确认后覆盖文件并自动重启。
3. Windows 覆盖失败时会自动恢复旧版本。更新期间出现系统授权提示时，需要允许更新程序继续。
4. Android 客户端发现新版本后会下载并校验 APK，然后打开系统安装器；首次使用需允许本应用安装未知来源应用。
5. Android 覆盖升级保留登录状态、策略参数和推送配置。新版 APK 必须使用与旧版相同的签名证书。
6. 首次启用热更新前，需要手动安装一次 Windows 1.1.30 或 Android 1.1.4；此后可由管理后台继续发布后续版本。

常见问题与处理方法

首次使用检查清单

• □已完成 Gate.io KYC，并准备独立交易资金。
• □已创建 API Key，关闭提现权限。
• □已绑定服务器 IP 206.187.209.107。
• □已在 Web、EXE 或 Android 中保存 API Secret。
• □API 连通性、现货读取和现货交易测试通过。
• □策略参数已核对，首次金额为小额。
• □已设置 Telegram 或 Bark，并完成测试推送。
• □已修改初始登录密码。
• □已确认主账户或子账户当前切换状态。
• □已了解紧急停止、手动平仓和授权续期方式。