mxjoly / binance-futures-trading-bot

A Binance trading bot using node.js

🤖 Binance trading bot

Features

• 🔨 Build your own strategy
• ✅ Can use multiple strategies at same time with different coins
• ⚙️ Configure the conditions to open / close a position
• 🎛 Multiple indicators to use for your strategies (moving averages, bollinger bands, rsi, macd, adx, ...)
• 🕰 Trading sessions
• ⏱ Limit the duration of the trades
• ✅ Multiple time frames can be used in a single strategy
• ✅ Money management
• 🩺 Backtesting with complete report (html file)
• 💊 Hyper parameters optimization
• ✅ Telegram channel notifications

Setup the environment

Install npm and dependecies

Linux

sudo rm -rf node_modules package-lock.json && npm install

Windows

remove directory node_modules and remove file package-lock.json

npm install

If crazy error, try: Note: remove directory node_modules and remove file package-lock.json

npm install @tensorflow/tfjs-node --ignore-scripts unit-tests --save
npm install nodemon -g
npm install -g win-node-env

Development

Set your api keys to the environment variables for testnet in .env with BINANCE_FUTURES_TESTNET_PUBLIC_KEY and BINANCE_FUTURES_TESTNET_PRIVATE_KEY. Go to https://testnet.binancefuture.com/en/futures/BTCUSDT and https://testnet.binance.vision/ to get your keys. Then run the commands:

npm run build:dev
npm run dev

Production

Get your api keys from your Binance account and set them to the environment variables BINANCE_PUBLIC_KEY and BINANCE_PRIVATE_KEY in the file .env. Then, run the commands:

npm run build:prod
npm run prod

Create your strategy

You can create your own strategy for your bot. The file must be placed in src/configs. There are some examples to help you to create the best strategy. Check the declaration file global.d.ts to have an overview of the possibilities you can add to your strategy. And don't forget to backtest your strategy before running it in production !

Backtest your strategy

You can backtest your strategy by running the backtest mode. To do that, you need to:

1. Configure the properties for your backtest in config.json.
2. Tap the commands npm build:test and npm run test to run the backtest.
3. When the backtest ends, it generates a log file in the folder logs and an html report in reports. You can consulting these to evaluate the performance and profitability of your strategy (note that the results in real will be a little different cause of the funding rates).

Configure the Telegram Channel

See https://core.telegram.org/bots to configure the channel. Then, set up your bot api key to the environment variable TELEGRAM_TOKEN and the id of the chat with TELEGRAM_CHAT_ID.

Machine Learning

In progress...

Todo

• Add custom Telegram channel with the notifications of the robot when an action is executed
• Trade managements

Documentation

• https://github.com/binance/binance-spot-api-docs/blob/master/rest-api.md
• https://github.com/Ashlar/binance-api-node/blob/master/README.md
• https://binance-docs.github.io/apidocs/spot/en/
• https://binance-docs.github.io/apidocs/futures/en/

License

MIT.

binance-futures-trading-bot's Issues

You use a time frame not supported by the robot

binance-futures-trading-bot/src/init/initStrategy.ts

Line 66 in f625122

.filter((interval) => interval !== null || interval !== undefined)

.filter((interval) => interval !== null && interval !== undefined)

Error try run project

Fail try execute this command:

npm run build:dev
npm run dev

return:

src/backtest/bot.ts:377:13 - error TS2345: Argument of type 'ExchangeInfo<FuturesOrderType_LT>' is not assignable to parameter of type 'ExchangeInfo<OrderType_LT>'.

377             exchangeInfo
                ~~~~~~~~~~~~

src/backtest/bot.ts:387:15 - error TS2345: Argument of type 'ExchangeInfo<FuturesOrderType_LT>' is not assignable to parameter of type 'ExchangeInfo<OrderType_LT>'.

387               exchangeInfo
                  ~~~~~~~~~~~~

src/bot.ts:93:5 - error TS2322: Type 'ExchangeInfo<FuturesOrderType_LT>' is not assignable to type 'ExchangeInfo<OrderType_LT>'.
  Type 'FuturesOrderType_LT' is not assignable to type 'OrderType_LT'.
    Type '"TAKE_PROFIT"' is not assignable to type 'OrderType_LT'.

93     this.exchangeInfo = await binanceClient.futuresExchangeInfo();
       ~~~~~~~~~~~~~~~~~

src/bot.ts:365:19 - error TS2322: Type 'number' is not assignable to type 'string'.

365                   price,
                      ~~~~~

src/bot.ts:384:19 - error TS2322: Type 'number' is not assignable to type 'string'.

384                   stopPrice: stopLoss,
                      ~~~~~~~~~

src/bot.ts:394:19 - error TS2322: Type 'number' is not assignable to type 'string'.

394                   stopPrice: stopLoss,
                      ~~~~~~~~~

src/bot.ts:395:19 - error TS2322: Type 'number' is not assignable to type 'string'.

395                   price: stopLoss,
                      ~~~~~

src/bot.ts:484:19 - error TS2322: Type 'number' is not assignable to type 'string'.

484                   price: price,
                      ~~~~~

src/bot.ts:503:19 - error TS2322: Type 'number' is not assignable to type 'string'.

503                   stopPrice: stopLoss,
                      ~~~~~~~~~

src/bot.ts:513:19 - error TS2322: Type 'number' is not assignable to type 'string'.

513                   stopPrice: stopLoss,
                      ~~~~~~~~~

src/bot.ts:514:19 - error TS2322: Type 'number' is not assignable to type 'string'.

514                   price: stopLoss,
                      ~~~~~

src/utils/__tests__/currencyInfo.test.ts:16:5 - error TS2322: Type 'ExchangeInfo<FuturesOrderType_LT>' is not assignable to type 'ExchangeInfo<OrderType_LT>'.

16     exchangeInfo = await binanceClient.futuresExchangeInfo();
       ~~~~~~~~~~~~


Found 12 errors in 3 files.

Errors  Files
     2  src/backtest/bot.ts:377
     9  src/bot.ts:93
     1  src/utils/__tests__/currencyInfo.test.ts:16
Note: This command was run via npm module 'win-node-env'

Help me!!! Plz

Thank you.

There is no issue. I want to thank you for creating this repo and open source it. 🙏