币安网格交易机器人

Binance_grid_trader 是一款基于币安现货和币安期货交易所的网格策略交易机器人。您可以使用它在币安交易所交易任何交易对。

中文文档 葡萄牙语

教程视频

使用方法

首先，下载代码。然后创建一个 Python 虚拟环境，您可以使用 Anaconda 来创建环境。

conda create -n trader python==3.7

这样就创建了一个名为 trader 的虚拟环境。要激活该环境，可以使用以下命令：

conda activate trader

其次，您需要使用 pip 安装所需的库。

pip install -r requirements.txt

requirements.txt 文件位于项目目录中，列出了项目所依赖的库。

安装完库后，您可以运行 main.py。如果您使用 PyCharm，可能需要配置项目的解释器。

python main.py

注意：如果您运行 main.py，将会看到窗口界面。如果希望无界面运行，可以分别运行 main_futures_script.py 或 main_spot_script.py，它们分别用于币安期货或现货市场。

配置币安期货 API 并连接币安期货 API

点击左上角的“配置币安 API”按钮（靠近 Python 按钮），选择“连接期货”。

1. key：将您的币安交易所 API 管理中的 API Key 粘贴到这里。
2. secret：将您的币安交易所 API 管理中的 API Secret 粘贴到这里，并确保已修改 API 权限限制，允许进行期货交易。
3. futures_types：如果您想交易以 USDT 或 BUSD 结算的合约，例如 BTCUSDT、BTCBUSD 等符号，请将其设置为 USDT；否则设置为 COIN。
4. proxy_host 和 proxy_port：如果您可以直接连接到币安交易所，则保持为空。如果无法直接连接到币安交易所，您可能需要配置代理主机或端口。如果您正在使用 VPN 软件，则将代理主机设置为 127.0.0.1；否则需要设置为远程服务器的 IP 地址。

所有 API 配置数据将保存在项目目录下的 gridtrader/connect_futures.json 文件中。

注意：每次运行网格策略之前，都需要先连接 API。要连接币安 API，请点击“确认”按钮。

配置币安现货 API 并连接币安现货 API

点击左上角的“配置币安 API”按钮（靠近 Python 按钮），选择“连接现货”。

1. key：将您的币安交易所 API 管理中的 API Key 粘贴到这里。
2. secret：将您的币安交易所 API 管理中的 API Secret 粘贴到这里，并确保已修改 API 权限限制，允许进行期货交易。
3. proxy_host 和 proxy_port：如果您可以直接连接到币安交易所，则保持为空。如果无法直接连接到币安交易所，您可能需要配置代理主机或端口。如果您正在使用 VPN 软件，则将代理主机设置为 127.0.0.1；否则需要设置为远程服务器的 IP 地址。

所有 API 配置数据将保存在项目目录下的 gridtrader/connect_spot.json 文件中。

注意：每次运行网格策略之前，都需要先连接 API。要连接币安 API，请点击“确认”按钮。

添加期货网格策略

如果您想在期货市场中运行网格策略，可以添加 FutureGridStrategy。以下是该策略的参数说明：

1. strategy_name：为策略命名。

2. vt_symbol：您想要交易的交易对符号，例如 BTCUSDT、ETHBUSD 等。请注意，在期货市场中应使用大写字母；如果使用小写字母，策略将运行在现货市场。

3. upper_price：网格的最高价格。如果您将 upper_price 设置为 40000，这意味着当市场价格超过 40000 时，策略将不会下达任何订单。

4. bottom_price：策略的最低价格。如果您将 bottom_price 设置为 30000，当价格低于 30000 时，策略也不会下达任何订单。

5. grid_number：策略的网格数量。如果 upper_price 为 40000，bottom_price 为 30000，且 grid_number 为 100，则每个网格步长（即订单价格步长）为 (40000 - 30000) / 100 = 100。

6. order_volume：您的订单数量/成交量。

7. max_open_orders：买入或卖出方向的最大未成交订单数。

策略设置数据将保存在 gridtrader/grid_strategy_setting.json 文件中，您可以查看并修改。

此外，gridtrader/grid_strategy_data.json 文件将在策略运行时保存一些变量。

添加现货网格策略

如果您想在现货市场中运行网格策略，可以添加 SpotGridStrategy。以下是该策略的参数说明：

1. strategy_name：为策略命名。

2. vt_symbol：您想要交易的交易对符号，例如 btcusdt、ethbusd 等。请注意，在现货市场中应使用小写字母；如果使用大写字母，策略将运行在期货市场。

3. upper_price：网格的最高价格。如果您将 upper_price 设置为 40000，这意味着当市场价格超过 40000 时，策略将不会下达任何订单。

4. bottom_price：策略的最低价格。如果您将 bottom_price 设置为 30000，当价格低于 30000 时，策略也不会下达任何订单。

5. grid_number：策略的网格数量。如果 upper_price 为 40000，bottom_price 为 30000，且 grid_number 为 100，则每个网格步长（即订单价格步长）为 (40000 - 30000) / 100 = 100。

6. order_volume：您的订单数量/成交量。

7. invest_coin：如果您想交易 btcusdt，则设置为 USDT；如果您想交易 btcbusd，则设置为 BUSD；如果您想交易 ethbtc，则设置为 BTC。

8. max_open_orders：买入或卖出方向的最大未成交订单数。

策略设置数据将保存在 gridtrader/grid_strategy_setting.json 文件中，您可以查看并修改。

此外，gridtrader/grid_strategy_data.json 文件将在策略运行时保存一些变量。

启动您的网格策略

如果您想启动网格策略，需要执行以下步骤：

1. 初始化策略：点击“初始化”按钮。
2. 启动策略：点击“启动”按钮。

如果您想停止策略，可以点击“停止”按钮，或者点击“编辑”按钮来修改策略参数。

如果您有多个策略需要批量启动，可以点击“初始化所有策略”和“启动所有策略”。

使用脚本

如果想在 Linux 系统中运行代码，或者 simply 不想使用图形界面，可以使用脚本。如果你想进行现货交易，请查看 main_spot_script.py；如果想进行期货交易，请查看 main_futures_script.py。

但在运行脚本之前，你需要编辑 gridtrader/grid_strategy_setting.json 文件，配置好你的策略参数。

联系方式

微信：bitquant51

Discord：51bitquant#8078

如果你有任何问题，欢迎随时通过 Discord 联系我。如果你还没有 Binance 账户，可以使用以下链接注册： Binance 推荐链接，注册后你将获得 20% 的手续费返佣。

免责声明

我不保证该机器人能够在市场中盈利，请自行承担风险使用。在未仔细阅读代码之前，请勿将真实资金投入市场。请务必谨慎操作，后果自负。

Binance Grid Trader 快速上手指南

Binance Grid Trader 是一款支持币安现货（Spot）和合约（Futures）市场的网格交易机器人。本指南将帮助你快速在本地部署并运行该工具。

环境准备

• 操作系统：Windows / Linux / macOS
• Python 版本：推荐 Python 3.7
• 依赖管理：推荐使用 Anaconda 或 Miniconda 创建虚拟环境
• 网络要求：需能连接币安交易所 API（若无法直连，需配置代理）

安装步骤

1. 获取代码

首先下载项目源代码到本地。

2. 创建虚拟环境

使用 Conda 创建名为 trader 的 Python 3.7 环境：

conda create -n trader python==3.7

激活环境：

conda activate trader

3. 安装依赖库

进入项目目录，安装 requirements.txt 中列出的依赖包。 (注：国内用户若下载缓慢，可临时指定清华源加速)

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

基本使用

本项目提供图形界面（UI）和脚本两种运行方式。

方式一：图形界面启动（推荐新手）

直接运行主程序即可打开配置窗口：

python main.py

核心操作流程：

1. 配置 API：

   • 点击左上角 Config Binance Api 按钮。
   • 选择 Connect Futures（合约）或 Connect Spot（现货）。
   • 填入从币安后台获取的 API Key 和 Secret。
   • 注意：需在币安后台编辑 API 权限，勾选“允许合约交易”或“允许现货交易”。
   • 若使用代理，填写 proxy_host (如 127.0.0.1) 和 proxy_port；否则留空。
   • 点击 Confirm 保存配置。

2. 添加策略：

   • 在界面中添加 FutureGridStrategy（合约）或 SpotGridStrategy（现货）。
   • 配置关键参数：
     • vt_symbol: 交易对（合约请用大写如 BTCUSDT，现货请用小写如 btcusdt）。
     • upper_price / bottom_price: 网格价格区间上下限。
     • grid_number: 网格数量。
     • order_volume: 单笔订单数量。
     • invest_coin: (仅现货) 计价币种，如 USDT, BUSD, BTC。

3. 运行策略：

   • 选中策略，点击 Init 初始化。
   • 点击 Start 开始运行。
   • 如需批量操作，可使用 Init All Strategies 和 Start All Strategies。

方式二：无头脚本启动（适合服务器/Linux）

若无需图形界面，可直接运行脚本。运行前需手动编辑 gridtrader/grid_strategy_setting.json 文件配置策略参数。

• 运行现货策略：

  python main_spot_script.py
  

• 运行合约策略：

  python main_futures_script.py
  

---

风险提示：本工具不保证盈利，市场有风险，使用前请仔细阅读代码并在测试环境中验证。