币安交易机器人

自动化币安交易机器人，采用追踪式买入/卖出策略

---

这是一个测试项目。我只是在测试我的代码。

警告

我无法保证您是否能盈利。

因此，请自行承担风险使用！对于因使用本代码而直接或间接造成的任何损失或困难，我概不负责。请在使用本代码前阅读 免责声明。

在更新机器人之前，请务必记录下上次的买入价格。否则可能会丢失配置或上次买入价格的记录。

工作原理

追踪网格交易买入/卖出机器人

该机器人采用追踪式买入/卖出订单的概念，能够跟随价格的下跌或上涨。

追踪止损单 关于追踪止损单的概念，您可以参考 Binance官方文档

简而言之： 当价格发生变化时，按照固定值或百分比下单。利用此功能，在下跌时可以以尽可能低的价格买入，而在上涨时则可以以尽可能高的价格卖出。

• 该机器人支持基于配置的多个买入/卖出订单。
• 机器人可以监控多个交易品种。所有品种将每秒进行一次监控。
• 机器人使用MongoDB作为持久化数据库。然而，为了兼容树莓派32位系统，未使用最新版本的MongoDB。所使用的MongoDB版本为3.2.20，由apcheamitru提供。
• 该机器人已在Linux和树莓派4 32位上进行了测试并正常运行。其他平台尚未经过测试。

买入信号

机器人会根据网格交易配置持续监控指定的币种。

对于网格交易#1，当当前价格达到最低价时，机器人将下达一个止损限价单进行买入。如果当前价格持续下跌，则机器人会取消之前的订单，并以新的价格重新下达止损限价单。

完成网格交易#1后，机器人将根据最后一次买入的价格继续监控该币种。

• 如果持有的币量足够（通常价值超过10美元），并且达到卖出触发价格时，机器人将不会执行网格交易#1的买入订单。
• 如果预计的价值低于最后一次买入价格的移除阈值，则机器人会移除最后一次买入价格。

买入场景

假设买入网格交易的配置如下：

• 网格数量：2
• 网格

  序号	触发百分比	止损百分比	限价百分比	USDT
  1	1	1.05	1.051	50
  2	0.8	1.03	1.031	100

为了便于理解，我将用“$”来表示USDT符号。为了简化计算，我没有考虑手续费。在实际交易中，数量可能会有所不同。

您的第一个买入网格交易配置如下：

• 网格序号：1
• 触发百分比：1
• 止损百分比：1.05（5.00%）
• 限价百分比：1.051（5.10%）
• 最大购买金额：50美元

市场情况如下：

• 当前价格：105美元
• 最低价：100美元
• 刺激价格：100美元

当当前价格跌至最低价（100美元）且低于ATH（历史最高价）限制价格时（如果已启用），机器人将下达一个新的止损限价单进行买入。

• 止损价格：100美元 × 1.05 = 105美元
• 限价价格：100美元 × 1.051 = 105.1美元
• 数量：0.47573

假设市场变化如下：

• 当前价格：95美元

那么机器人将跟随价格下跌，并下达新的止损限价单：

• 止损价格：95美元 × 1.05 = 99.75美元
• 限价价格：95美元 × 1.051 = 99.845美元
• 数量：0.5

假设市场变化如下：

• 当前价格：100美元

此时机器人将执行第一次买入操作。最后的买入价格将被记录为99.845美元。买入的数量为0.5个单位。

一旦买入完成，机器人将开始监控卖出信号，同时继续监控下一个买入网格交易。

您的第二个买入网格交易配置如下：

• 网格序号：2
• 上次买入价格：99.845美元
• 触发百分比：0.8（20%）
• 止损百分比：1.03（3.00%）
• 限价百分比：1.031（3.10%）
• 最大购买金额：100美元

如果当前价格持续下跌至79.876美元（比上次买入价格低20%），机器人将为第二次买入下达新的止损限价单。

假设市场变化如下：

• 当前价格：75美元

那么机器人将跟随价格下跌，并下达新的止损限价单：

• 止损价格：75美元 × 1.03 = 77.25美元
• 限价价格：75美元 × 1.031 = 77.325美元
• 数量：1.29

假设市场变化如下：

• 当前价格：78美元

此时机器人将执行第二次买入操作。最后的买入价格将自动重新计算如下：

• 最终买入价格：（50美元 + 100美元）/（0.5个币 + 1.29个币）= 83.80美元

买入配置详解

关于买入配置的详细说明，请参阅以下链接：

https://github.com/chrisleekr/binance-trading-bot/wiki/Buy-Scenario

卖出信号

如果账户余额充足且机器人已记录上次买入价格，则机器人将开始监控网格交易#1的卖出信号。一旦当前价格达到网格交易#1的触发价格，机器人将下达一个止损限价单进行卖出。若当前价格持续上涨，机器人将取消之前的订单，并以新的价格重新下达止损限价单。

• 如果机器人没有记录上次买入价格，则不会卖出该币种。
• 如果该币种的价值低于上次买入价格的移除阈值，机器人将移除上次买入价格。
• 如果该币种的价值低于最小名义价值，机器人将不会下达任何订单。

卖出场景

假设卖出网格交易的配置如下：

• 网格数量：2
• 网格配置：

  序号	触发百分比	止损百分比	限价百分比	卖出数量百分比
  1	1.05	0.97	0.969	0.5
  2	1.08	0.95	0.949	1

与买入不同，卖出配置使用数量的百分比。如果你想卖出全部持仓，只需将其配置为1（即100%）。

根据最近的买入操作，你现在拥有以下余额：

• 当前数量：1.79
• 当前最后一次买入价格：83.80美元

你的第一个卖出网格交易配置如下：

• 网格序号#1
• 触发百分比：1.05
• 止损百分比：0.97
• 限价百分比：0.969
• 卖出数量百分比：0.5

假设市场行情变化如下：

• 当前价格：88美元

由于当前价格高于卖出触发价格（87.99美元），机器人将下达新的止损限价单进行卖出。

• 止损价格：88美元 × 0.97 = 85.36美元
• 限价价格：88美元 × 0.969 = 85.272美元
• 卖出数量：0.895

假设市场行情再次变化如下：

• 当前价格：90美元

此时机器人会跟随价格上涨，重新下达止损限价单：

• 止损价格：90美元 × 0.97 = 87.30美元
• 限价价格：90美元 × 0.969 = 87.21美元
• 卖出数量：0.895

假设市场行情进一步变化如下：

• 当前价格：87美元

此时机器人将执行第一次卖出操作。随后，机器人将等待第二次卖出触发价格（83.80美元 × 1.08 = 90.504美元）。

• 当前数量：0.895
• 当前最后一次买入价格：83.80美元

假设市场行情再次变化如下：

• 当前价格：91美元

由于当前价格（91美元）高于第二次卖出触发价格（90.504美元），机器人将下达新的止损限价单：

• 止损价格：91美元 × 0.95 = 86.45美元
• 限价价格：91美元 × 0.949 = 86.359美元
• 卖出数量：0.895

假设市场行情继续变化如下：

• 当前价格：100美元

此时机器人将再次跟随价格上涨，重新下达止损限价单：

• 止损价格：100美元 × 0.95 = 95美元
• 限价价格：100美元 × 0.949 = 94.9美元
• 卖出数量：0.895

假设市场行情最终变化如下：

• 当前价格：94美元

此时机器人将执行第二次卖出操作。

最终收益计算如下：

• 第一次卖出：84.9美元 × 0.895 = 84.9355美元
• 第二次卖出：78.05美元 × 0.895 = 78.05295美元
• 总收益：162美元（8%利润）

卖出配置详解

关于买入配置的详细说明，请参阅此处文档：

https://github.com/chrisleekr/binance-trading-bot/wiki/Sell-Scenario

功能特性

• 手动交易
• 将小额余额转换为BNB
• 交易所有币种
• 同时监控多只币种
• 止损功能
• 限制在历史最高价上方买入
• 网格交易（买入/卖出）
• 集成TradingView技术分析

前端 + WebSocket

基于React.js的前端通过WebSocket进行通信：

• 列出正在监控的币种及其买卖信号、未成交订单
• 查看账户余额
• 查看已开/已平仓的交易记录
• 管理全局及特定币种的设置
• 清除未监控的缓存数据
• 提供公共访问链接
• 支持添加到主屏幕
• 前端安全性保障

环境参数

可通过环境参数调整各项配置。请查看/config/custom-environment-variables.json文件，了解可用的环境参数列表。

此外，您也可以在应用启动后通过前端界面调整相关配置。

使用方法

1. 根据 .env.dist 文件创建 .env 文件。

   环境变量键	描述	示例值
   BINANCE_LIVE_API_KEY	生产环境下的币安 API 密钥	（来自 币安）
   BINANCE_LIVE_SECRET_KEY	生产环境下的币安 API 秘钥	（来自 币安）
   BINANCE_TEST_API_KEY	测试环境下的币安 API 密钥	（来自 币安现货测试网）
   BINANCE_TEST_SECRET_KEY	测试环境下的币安 API 秘钥	（来自 币安现货测试网）
   BINANCE_SLACK_ENABLED	是否启用 Slack 通知	true
   BINANCE_SLACK_WEBHOOK_URL	Slack Webhook URL	（来自 Slack）
   BINANCE_SLACK_CHANNEL	Slack 频道	"#binance"
   BINANCE_SLACK_USERNAME	Slack 用户名	Chris
   BINANCE_LOCAL_TUNNEL_ENABLED	是否启用本地隧道 localtunnel	true
   BINANCE_LOCAL_TUNNEL_SUBDOMAIN	本地隧道的公共 URL 子域名	binance
   BINANCE_AUTHENTICATION_ENABLED	是否启用前端身份验证	true
   BINANCE_AUTHENTICATION_PASSWORD	前端登录密码	123456
   BINANCE_LOG_LEVEL	日志级别。可能值参见 bunyan 文档。	ERROR

   本地隧道使机器人可以从外部访问。请将本地隧道的子域名设置为只有你自己能记住的子域名。 必须更改身份验证密码；否则，它将被配置为默认密码。

2. 使用 docker-compose 启动或更新机器人

   首先拉取最新代码：

   git pull
   

   如果需要生产/上线模式，则使用 DockerHub 上的最新构建镜像：

   docker-compose -f docker-compose.server.yml pull
   docker-compose -f docker-compose.server.yml up -d
   

   或者，如果需要开发/测试模式，则运行以下命令：

   docker-compose up -d --build
   

3. 打开浏览器 http://0.0.0.0:8080 查看前端界面

   • 应用启动时，会将公开 URL 通知到 Slack。
   • 如果机器人出现任何问题，可以查看日志以了解具体原因。请参阅 故障排除

通过 Stackfile 安装

1. 在 Portainer 中创建新的 Stack

2. 复制 docker-stack.yml 的内容或上传该文件

3. 在 docker-stack.yml 中设置 binance-bot 的环境变量

4. 启动并打开浏览器 http://0.0.0.0:8080 查看前端界面

截图

密码保护	前端移动端

设置	手动交易

前端桌面版	已平仓交易

样例交易

图表	买入订单	卖出订单

变更与待办事项

请参阅 CHANGELOG.md 以查看过往的变更记录。

• 开发用于管理密钥的简易设置界面
• 允许在买入操作之前执行止损 - #299
• 根据盈利百分比调整卖出策略中的条件止损价格百分比 - #94
• 添加突发下跌买入策略 - #67
• 管理设置配置文件（保存/更改/加载？/导出？）- #151
• 通过支持 Apprise 改进通知功能 - #106
• 支持在触及最低价后设置冷却时间再进行买入 - #105
• 将全局配置重置为初始配置 - #97
• 支持多语言前端界面 - #56
• 非线性止损价格及追涨功能 - #246
• 支持针对网格交易的逐笔卖出止损配置 - #261

捐赠

如果您觉得本项目对您有所帮助，请随时向开发者进行小额 捐赠。

致谢

• @d0x2f
• 以及众多其他贡献者！感谢大家！

贡献者

感谢所有贡献者 :heart: 点击查看我们的英雄们

免责声明

我对此项目中所包含的信息和资料的准确性或完整性不作任何保证，也不承担任何责任。在任何情况下，对于因您使用或无法使用本代码及其相关代码，或依赖于本代码上的信息和资料而直接或间接导致的任何索赔、损害、损失、费用、成本或其他责任（包括但不限于利润损失、业务中断或信息丢失等直接或间接损害），即使我事先已被告知可能发生此类损害，我也概不负责或承担任何责任。

因此，请您自行承担使用风险！

Binance Trading Bot 快速上手指南

Binance Trading Bot 是一个基于网格交易和追踪止损（Trailing Stop）策略的自动化币安交易机器人。它支持多币种监控、自动买入/卖出，并提供 React 前端界面进行实时管理。

⚠️ 风险提示：本项目仅供测试和学习使用。作者不保证盈利，使用本代码产生的任何资金损失或风险由用户自行承担。使用前请务必阅读免责声明。

环境准备

系统要求

• 操作系统：Linux 或 Raspberry Pi OS (已在 Linux 和 Raspberry Pi 4 32bit 上测试通过)
• 架构支持：支持 x86_64 及 ARM (arm32v7) 架构
• 内存：建议至少 512MB RAM

前置依赖

本项目推荐使用 Docker 部署，无需手动安装 Node.js 或 MongoDB。

• Docker Engine
• Docker Compose

安装步骤

1. 获取项目代码

克隆仓库到本地：

git clone https://github.com/chrisleekr/binance-trading-bot.git
cd binance-trading-bot

2. 配置环境变量

复制示例配置文件并编辑：

cp .env.dist .env
nano .env

在 .env 文件中填入你的币安 API 密钥（重要：请在币安后台创建 API Key 时，仅勾选"Spot & Margin Trading"权限，切勿开启提现权限）：

# 币安实盘 API Key
BINANCE_LIVE_API_KEY=你的 API_KEY
# 币安实盘 Secret Key
BINANCE_LIVE_SECRET_KEY=你的 SECRET_KEY

# 其他可选配置（如需要修改默认端口或数据库设置）
# PORT=8080
# MONGODB_URL=mongodb://mongo:27017/binance-bot

3. 启动服务

使用 Docker Compose 一键启动机器人后端、数据库及前端界面：

docker-compose up -d

启动完成后，可通过 docker-compose logs -f 查看运行日志。

基本使用

访问管理界面

打开浏览器访问机器人前端界面（默认端口为 8080，若修改请在 URL 中调整）：

http://<你的服务器 IP>:8080

配置交易策略

登录前端界面后，按以下步骤开始交易：

1. 全局设置：

   • 在 "Settings" 页面确认 API 连接状态。
   • 设置全局参数，如是否启用 ATH（历史最高价）限制买入、最小交易额阈值等。

2. 添加交易对：

   • 在 "Symbols" 页面添加你想监控的币种（如 BTCUSDT, ETHUSDT）。
   • 每个币种可独立配置网格交易参数。

3. 配置网格策略 (Grid Trade)：

   • 买入策略 (Buy Grids)：设置网格数量、触发百分比、止损/限价百分比及每格购买金额。
     • 示例：当价格下跌触发设定比例时，自动下追踪买单。
   • 卖出策略 (Sell Grids)：设置卖出触发比例、止损/限价百分比及卖出数量比例。
     • 示例：当价格上涨触发设定比例时，自动下追踪卖单获利。

4. 监控运行：

   • 在 "Dashboard" 查看实时余额、挂单状态及已成交记录。
   • 机器人将每秒监控市场价格，并根据配置自动调整或执行订单。

手动干预

• 手动交易：支持在前端界面手动执行买入或卖出操作。
• 清理缓存：若移除某个币种监控，可在设置中删除相关缓存数据。
• 小额兑换：可启用功能将账户中的小额资产自动兑换为 BNB。

注意：更新机器人版本前，请务必备份当前的“最后买入价格”记录，以免配置丢失导致策略异常。