币安交易机器人

一款用于币安的自动化加密货币交易机器人

作者

由 Eden Gaon 创建

项目状态

快速部署

社区

加入我们的 Telegram 社区，一起讨论策略、获取帮助或随意聊天吧！

社区 Telegram 聊天

https://t.me/binancetradebotchat

为什么？

该项目的灵感来源于这样一个观察：几乎所有加密货币的表现都大同小异。当一种币暴涨时，其他币也会跟着涨；而当一种币暴跌时，其他币同样会下跌——“几乎”如此。此外，所有币种都会跟随比特币的走势，只是在时间上存在一定的相位差。

因此，既然这些币种之间本质上是相互振荡的，那么在上涨的币种中卖出并买入下跌的币种，待两者比例反转后再换回来，似乎是一个明智的策略。

怎么做？

交易是在币安平台上进行的，但币安并不支持所有山寨币对的交易。为了解决这个问题，我们可以使用一种桥接币来补充缺失的交易对。默认的桥接币是 Tether (USDT)，它设计上非常稳定，并且几乎可以与平台上的任何币种进行交易。

币 A → USDT → 币 B

机器人利用这一现象的方式是：始终从“强势”币种兑换成“弱势”币种，假设在某个时刻市场情况会发生逆转。随后再将资金换回最初的币种，最终持有的该币数量会比最初更多。整个过程还会考虑到交易手续费的影响。

机器人会在一组预设的币种之间不断切换，但只有在当前持有的币种数量相比上次持有时有所增加的情况下，才会回到该币种。这意味着我们永远不会减少某种币的数量。不过，风险在于其中某一种币可能会突然相对于其他币大幅下跌，从而触发我们的反向贪婪算法。

币安设置

• 创建一个 币安账户（包含我的推荐链接，如果您使用它，我将不胜感激）。
• 启用双重身份验证。
• 创建一个新的 API 密钥。
• 获取一种加密货币。如果其符号不在默认列表中，请将其添加进去。

工具设置

安装 Python 依赖

在终端运行以下命令：pip install -r requirements.txt。

创建用户配置文件

根据 .user.cfg.example 文件创建一个名为 user.cfg 的配置文件，然后填入您的 API 密钥和当前持有的币种。

配置文件包含以下字段：

• api_key - 在币安账户设置阶段生成的币安 API 密钥。
• api_secret_key - 在币安账户设置阶段生成的币安密钥。
• testnet - 默认为 false，表示是否使用测试网络。
• current_coin - 这是您选择的起始币种。它应该是您支持的币种列表中的一个。如果您想从桥接币开始，可以将此字段留空——机器人会随机选择您支持的币种列表中的一个并买入。
• bridge - 您选择的桥接币。请注意，不同的桥接币会支持不同的币种组合。例如，可能存在特定币种/USDT 的交易对，但没有特定币种/BUSD 的交易对。
• tld - 根据您的地区选择 ‘com’ 或 ‘us’。默认为 ‘com’。
• hourToKeepScoutHistory - 控制数据库中保留多少小时的扫描数据。超过指定时间后，这些信息将会被删除。
• scout_sleep_time - 控制每次扫描之间等待的秒数。
• use_margin - 设置为 ‘yes’ 使用 scout_margin，设置为 ‘no’ 使用 scout_multiplier。
• scout_multiplier - 控制当前币种比例与之前比例之差的倍数。数值越大，机器人就会等待更大的价差出现后再进行交易。
• scout_margin - 每笔交易中币种价值的最小涨幅百分比。例如，0.8 对应于 0.1% 手续费下的 scout_multiplier 为 5。
• strategy - 使用的交易策略。更多信息请参阅 binance_trade_bot/strategies。
• buy_timeout/sell_timeout - 控制在取消限价单（买入/卖出）并返回“扫描”模式之前等待的分钟数。0 表示订单永远不会被提前取消。
• scout_sleep_time - 控制机器人在分析当前价格之间等待的秒数。由于机器人现在通过 WebSocket 运行，这个值应该设置得较低（比如 1）。只有在您发现机器人的 CPU 使用率过高，或者遇到关于请求权重限制的 API 错误时，才需要将此值调高。

环境变量

user.cfg 中提供的所有选项也可以通过环境变量进行配置。

CURRENT_COIN_SYMBOL:
SUPPORTED_COIN_LIST: "XLM TRX ICX EOS IOTA ONT QTUM ETC ADA XMR DASH NEO ATOM DOGE VET BAT OMG BTT"
BRIDGE_SYMBOL: USDT
API_KEY: vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A
API_SECRET_KEY: NhqPtmdSJYdKjVHjA7PZj4Mge3R5YNiP1e3UZjInClVN65XAbvqqM6A7H5fATj0j
SCOUT_MULTIPLIER: 5
SCOUT_SLEEP_TIME: 1
TLD: com
STRATEGY: default
BUY_TIMEOUT: 0
SELL_TIMEOUT: 0

使用 BNB 支付手续费

您可以 使用 BNB 支付币安平台上的任何手续费，这将使所有费用降低 25%。为了支持这一优惠，机器人将始终执行以下操作：

• 自动检测您是否启用了 BNB 支付手续费功能。
• 确保您的账户中有足够的 BNB 来支付当前交易的手续费。
• 在计算交易阈值时考虑折扣因素。

使用 Apprise 发送通知

Apprise 使机器人能够向所有流行的通知服务发送通知，例如：Telegram、Discord、Slack、Amazon SNS、Gotify 等。

要进行设置，您需要在配置目录中创建一个 apprise.yml 文件。

我们提供了一个示例文件，供您快速上手。

如果您有兴趣运行 Telegram 机器人，更多信息请参阅 Telegram 官方文档。

运行机器人

python -m binance_trade_bot

运行返回信息的服务器

python -m binance_trade_bot.api_server

Docker

官方镜像可在 这里 获取，并会在每次更新时自动同步。

docker-compose up

如果您只想启动 SQLite 浏览器：

docker-compose up -d sqlitebrowser

回测

您可以使用历史数据测试机器人，以了解其表现。

python backtest.py

请随意修改该文件，以测试和比较不同的设置及时间段。

开发

为确保在提交拉取请求之前代码格式正确，请务必安装 pre-commit：

pip install pre-commit
pre-commit install

侦察算法预计不会被更改。如果您希望贡献替代方法，请参阅 添加新策略。

相关项目

得益于一群才华横溢的开发者，现在有一个用于远程管理该项目的 Telegram 机器人。

支持本项目

加入聊天

• Discord：邀请链接

常见问题解答

常见问题的答案列表可在我们的 Discord 服务器的相关频道中找到。

想从头开始构建机器人吗？

• 请查看 CCXT，它支持超过 100 家加密货币交易所，并提供统一的交易 API。
• 也可以参考 Python-Binance，这是一个完整的 Python 封装库。

免责声明

本项目仅用于信息参考之目的。您不应将任何此类信息或其他材料视为法律、税务、投资、金融或其他方面的建议。此处所包含的内容不构成我或任何第三方服务提供商在任何司法管辖区内的证券法规定下非法的买卖任何证券或其他金融工具的招揽、推荐、背书或要约。

如果您计划使用真实资金，请务必自行承担风险。

在任何情况下，我都不会以任何形式对任何索赔、损害赔偿、损失、费用、成本或责任承担责任，包括但不限于因利润损失而产生的直接或间接损害。

Binance Trade Bot 快速上手指南

Binance Trade Bot 是一个自动化的加密货币交易机器人，旨在通过监测不同币种间的相对强弱变化，在币安（Binance）平台上自动执行“高卖低买”策略，从而增加持有币种的数量。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS 或 Windows (推荐 Linux 环境部署)
• Python 版本：Python 3.8 或更高版本
• 币安账户：
  • 已注册币安账号并启用双重验证 (2FA)。
  • 已创建 API Key，并勾选 Spot & Margin Trading (现货与杠杆交易) 权限。切勿勾选提现权限。
  • (可选但推荐) 开启使用 BNB 支付手续费功能，可享受 25% 费率折扣，机器人会自动识别此优惠。
• 资金准备：账户中需持有一定的起始加密货币（如 USDT 或其他主流币）。

安装步骤

1. 克隆项目代码

首先从 GitHub 获取源代码：

git clone https://github.com/edeng23/binance-trade-bot.git
cd binance-trade-bot

2. 安装依赖

建议使用虚拟环境，然后安装所需的 Python 库。国内用户若遇到下载缓慢，可指定清华源加速：

# 创建虚拟环境 (可选)
python3 -m venv venv
source venv/bin/activate  # Windows 用户使用: venv\Scripts\activate

# 安装依赖 (使用国内镜像加速)
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

3. 配置用户参数

在项目根目录下，复制示例配置文件并重命名：

cp .user.cfg.example user.cfg

编辑 user.cfg 文件，填入您的币安 API 信息和交易策略参数：

api_key = 您的_API_KEY
api_secret_key = 您的_API_SECRET_KEY
testnet = false
current_coin = BTC
bridge = USDT
tld = com
hourToKeepScoutHistory = 1
scout_sleep_time = 1
use_margin = no
scout_multiplier = 5
strategy = default
buy_timeout = 0
sell_timeout = 0

关键参数说明：

• current_coin: 您希望开始交易的起始币种（必须在支持列表中）。若留空，机器人将随机选择一个币种买入。
• bridge: 桥接币种，默认为 USDT。机器人将通过 币种 A -> USDT -> 币种 B 的方式进行转换。
• scout_multiplier: 决定交易触发的敏感度。数值越大，机器人等待的利润空间越大才进行交易。

提示：您也可以完全通过环境变量来配置，无需修改 .cfg 文件。例如： export API_KEY=您的_KEY

基本使用

方式一：直接运行机器人

配置完成后，直接在终端启动机器人：

python -m binance_trade_bot

启动后，机器人将开始扫描市场，根据设定的策略在不同币种间自动切换交易。

方式二：使用 Docker 部署（推荐）

如果您已安装 Docker 和 Docker Compose，这是最简便的部署方式：

docker-compose up

若只需查看数据库状态，可单独启动 SQLite 浏览器服务：

docker-compose up -d sqlitebrowser

方式三：启动 API 服务器（可选）

如果需要外部程序获取机器人状态数据，可启动内置 API 服务：

python -m binance_trade_bot.api_server

回测功能

在投入真实资金前，您可以使用历史数据测试策略表现：

python backtest.py

您可以修改 backtest.py 文件以测试不同的时间段和参数设置。

---

风险提示：本项目仅供学习和参考。加密货币交易存在高风险，使用真实资金时请务必谨慎，盈亏自负。