fedelucesoli / binance-dca-bot

A bot to automatically DCA (Dollar-Cost Average) buy cryptocurrency on Binance

Binance DCA (Dollar-Cost-Averaging) Bot

This bot allows you to sit back and relax while it automatically invests in cryptocurrency on the Binance exchange for you. The bot allows you to set up recurring buys for any cryptocurrency supported on the exchange at any interval you want. Both fiat to crypto and crypto to crypto purchases supported.

---

v2.0.0 breaking changes

Version 2.0.0 drops supports to config.js configuration file in favor of .env file or Environment Variables. New trades.js now supports all the required settings to perform crypto trades (same format as before), separating sensitive data (api keys, connection strings, emails) from the non-sensitive one (crypto pairs). All other settings (API/Telegram/SendGrid/MongoDB/...) needs to be set using Environment Varaibles or .env file.

---

Contents

• Binance DCA (Dollar-Cost-Averaging) Bot
  • v2.0.0 breaking changes
  • Contents
  • Setup
    • Generate API keys
    • Create the project
  • Configure the bot
    • Trades.js file
      • Trades object
    • Environment Variables (.env)
  • Running the bot
  • Deployment
  • Automating fiat deposits to Binance
  • Donations
  • TODO list
  • Disclaimer
  • License

Setup

Generate API keys

Create a new API key on Binance. You should select Enable Reading and Enable Spot & Margin Trading for the restrictions.

Create the project

Node.js v13 or higher required.

git clone https://github.com/lukeliasi/binance-dca-bot.git
cd binance-dca-bot
npm install

Configure the bot

All the required settings needs to be set using Environment Variables or .env file. The trades you want to make can be configured in a trades.js file in the root or with environment variables.

Rename the env.example to .env file for a quick bootstrap.

Trades.js file

Configure the trades.js file in the root, you can uncomment and edit the provided example file.

NB: you may also define trades as an Environment Variables (see section below).

Trades object

Parameter	Description
asset	The asset you want to buy
currency	The currency you want to use to buy the asset. E.g: "USD", "GBP", "BTC" etc...
quoteOrderQty or quantity	Use quoteOrderQty for the amount you want to spend/invest or alternatively you can set quantity to buy a set amount of the asset regardless of price. Note Binance trading rules pairs have minimum and maximum order sizes
schedule	A cron expression to set when the buy order should execute for this asset. See Crontab.guru for help setting up schedules. You can omit this schedule parameter and the buy order will execute immediately

Environment Variables (.env)

NB: TRADES environment variable has priority over the trades.js file values.

These are all the supported settings:

Name	Description	Required
BINANCE_KEY	Your Binance API Key	YES
BINANCE_SECRET	Your Binance API Secret	YES
BINANCE_TESTNET	Set to true if you would like to connect to the Binance Testnet API	NO
SENDGRID_SECRET	SendGrid API key for the bot to send you email notifications when buy orders are executed	NO
SENDGRID_FROM	If using SendGrid notifications this is the sender email address	NO
SENDGRID_TO	If using SendGrid notifications this is the recipient email address	NO
TELEGRAM_TOKEN	If using Telegram notifications this value is the BotFather's generated token	NO
TELEGRAM_CHAT_ID	If using Telegram notifications this value is the chat identifier to which send notification	NO
MONGODB_URI	If using MongoDb Atlas this is the connection string	NO
TRADES	This is the stringified version of the trades.js file content	ONLY IF NOT USING trades.js

Running the bot

Use this command to start the bot: npm run start. The program must stay running, and it will execute the buy orders at the defined schedules using cron jobs.

Alternative: Using Docker

You can also build a Docker image of the bot and run it without having to install Node.js. To do that, and assuming Docker is installed, first build the image:

docker build -t binance-dca-bot .

then you can execute it with:

docker run -v $PWD/trades.js:/app/trades.js binance-dca-bot

Deployment

Consider running the bot in the cloud, so you do not need to run the bot constantly on your machine.

Some options:

• Vultr - $100 free credit using link
• Digital Ocean - $100 free credit using link
• Linode
• Heroku

You will want to use PM2 process manager or similar on the server which keeps the bot running and can restart the bot automatically if the server or program crashes.

Remember the remote server may be in a different timezone to you, run the command date to see the servers timezone to configure your cron accordingly.

NB: If you are using Heroku, the free tier is enough for this bot. Please consider to use Kaffeine to keep the bot awake.

Automating fiat deposits to Binance

For further automation you can deposit funds into your Binance account automatically via bank transfer. Simply initiate a fiat deposit (bank transfer) via the Binance website and note down the bank details you need to pay to. The reference code and other details never change, so you can set up a standing order with your bank to automatically transfer money to Binance on a schedule with these details.

As an exmaple, you could set up a standing order to deposit to Binance the day after you get paid, and then configure the bot to purchase your crypto the following day.

Donations

If you found this project helpful and would like to support me, you can donate to one of the following crypto addresses:

• BTC: 1LeisHRv4yLyzQg6M79f48ej9cnkruh6WH
• ETH: 0x804d2f31cc49a68011271b1d56884d0efa9e9ce9
• DOGE: DBa2UFwonN4QcunXY8Thev9oCxMkDrr9rm
• XRP: rEb8TK3gBgk5auZkwc6sHnwrGVJH8DuaLh tag: 101391719
• USDT: 0x804d2f31cc49a68011271b1d56884d0efa9e9ce9

TODO list

• Add features to README such as Telegram and MongoDB integrations
• Write tests
• Standardised messaging across all notification/storage platforms, email, terminal/cli, Mongo, Telegram etc...

Disclaimer

Use at your own risk. I am not liable for how you use the bot.

License

MIT License