Home

Awesome

Binance Grid Trader

Binance_grid_trader is a grid strategy bot trading with Binance Spot and Binance Future Exchange. you can use it to trade any pair in Binance Exchange.

中文文档 Portuguese

Tutorial Video

how-to-use

First, download the codes. Then create a python virtual env, you can use the anaconda to create the env.

conda create -n trader python==3.7

then you have an env(trader), to use this env, you can use the following command to activate the env.

conda activate trader

Second, you need to use the pip to install the libraries.

pip install -r requirements.txt

the requirements.txt is in the project. It lists the libraries the project rely on.

After install the libraries, you can run the main.py, if you use the pycharm, you may need to configure your project's interpreter.

python main.py

Note: if you run the main.py, you will see the Window UI, if you want to run without ui, you can run the main_futures_script.py or main_spot_script.py, they are for the binance futures or spot exchange.

<img src="resources/img_window.png" width="1000" height="612" alt="window picture"/>

Config Binance Future Api and connect Binance Futures Api

Click the top-left Config Binance Api button, near the python button and select Connect Futures.

<img src="resources/connect_future_usdt.png" alt="connect_future_usdt"/>
  1. key: past your api key from binance exchange Api management here.

  2. secret: past your api secret from binance exchange Api management, and remember to edit your api restrictions to allow trade futures.

  3. futures_types: if you want to trade contracts settled in USDT or BUSD like BTCUSDT, BTCBUSD symbol, set it to USDT else set it to COIN.

  4. proxy_host and proxy_port, if you can connect to binance exchange, then leave it blank. If you can't connect directly to Binance exchange, you may need to config the proxy_host or proxy_port. If you have run vpn software, then set the proxy_host to 127.0.0.1 else you need to set the proxy_host to a remote server ip.

All your config api data will save in project directory gridtrader/connect_futures.json file.

NOTE: Remember every time you run the grid strategy, you need to connect the api your api First.To connect the binance api, Click the confirm button.

Config Binance Spot Api and connect Binance Spot Api

Click the top-left Config Binance Api button, near the python button and select Connect Spot.

<img src="resources/connect_spot.png" alt="connect_future_usdt"/>
  1. key: past your api key from binance exchange Api management here.

  2. secret: past your api secret from binance exchange Api management, and remember to edit your api restrictions to allow trade futures.

  3. proxy_host and proxy_port, if you can connect to binance exchange, then leave it blank. If you can't connect directly to Binance exchange, you may need to config the proxy_host or proxy_port. If you have run vpn software, then set the proxy_host to 127.0.0.1 else you need to set the proxy_host to a remote server ip.

All your config api data will save in project directory gridtrader/connect_spot.json file.

NOTE: Remember every time you run the grid strategy, you need to connect the api your api First.To connect the binance api, Click the confirm button.

Add Futures Grid Strategy

<img src="resources/add_future_grid_strategy.png" alt="window picture"/> If you want to run the grid strategy in Futures Market, you can add the FutureGridStrategy. The following is the parameters description for the strategy:
  1. strategy_name: set a name for the strategy.

  2. vt_symbol: the symbol you want to trade, like BTCUSDT, ETHBUSD ect. for Future, remember to use the uppercase. if you use the lower case, you will run in the Spot market.

  3. upper_price: the grid highest price, if you set the upper_price to 40000, that means if the market price is over 40000, the strategy won't place any order.

  4. bottom_price: the lowest price fo the strategy. If you set the bottom_price to 30000, if the price is under 30000, the strategy won't place any order.

  5. grid_number, the grid number for the strategy, if the upper_price is 40000, the bottom_price is 30000, if the grid_number is 100, the grid step(or the order price step) is (40000- 30000)/100 = 100

  6. order_volume: your order volume/quantity

  7. max_open_orders: the max open order in buy/sell side.

The strategy settings data will save in gridtrader/grid_strategy_setting.json, you can checkout and modify it.

And the gridtrader/grid_strategy_data.json file will save some variables in the strategy when runnning.

Add Spot Grid Strategy

<img src="resources/add_spot_grid_strategy.png" alt="window picture"/>

If you want to run the grid strategy in Spot Market, you can add the SpotGridStrategy. The following is the parameters description for the strategy:

  1. strategy_name: set a name for the strategy.

  2. vt_symbol: the symbol you want to trade, like btcusdt, ethbusd ect. for spot market, remember to use the lowercase. if you use the lower case, you will run in the Spot market.

  3. upper_price: the grid highest price, if you set the upper_price to 40000, that means if the market price is over 40000, the strategy won't place any order.

  4. bottom_price: the lowest price fo the strategy. If you set the bottom_price to 30000, if the price is under 30000, the strategy won't place any order.

  5. grid_number, the grid number for the strategy, if the upper_price is 40000, the bottom_price is 30000, if the grid_number is 100, the grid step(or the order price step) is (40000- 30000)/100 = 100

  6. order_volume: your order volume/quantity

  7. invest_coin: if you want to trade btcusdt, then set to USDT, if you want to trade btcbusd, then set to BUSD, if you want to trade ethbtc, then set to btc.

  8. max_open_orders: the max open order in buy/sell side.

The strategy settings data will save in gridtrader/grid_strategy_setting.json, you can checkout and modify it.

And the gridtrader/grid_strategy_data.json file will save some variables in the strategy when runnning.

Start Your Grid Strategy

<img src="resources/start_strategy.png" alt="window picture"/>

If you want to start the grid strategy, you need to:

  1. Init your strategy: Click the Init Button

  2. Start your strategy: Click the Start Button.

If you want to stop the strategy, click the Stop button, or even click edit button to edit the strategy's parameters.

If you have a lot of strategies to start in batch, you can click Init All Strategies and Start All Strategies.

using script

If want to run the code in Linux system or just don't want to use the UI, you can use the script. If you want to trade in spot market, checkout the main_spot_script.py. If you want to trade in the future market, checkout the main_futures_script.py

But before run the script, you need to edit the gridtrader/grid_strategy_setting.json file, then config your strategy setting.

contact

wechat: bitquant51

discord: 51bitquant#8078

IF you have any question, please feel free to contact me in discord. If you don't have a binance account, I'm happy you can use the following link to register the account: Binance referral LINK, and you will get 20% commission rebate.

disclaimer

I don't guarantee that this bot can make profit from market, use it at your risk. Don't put your real money into the market before you read the codes. Use at your own risk.