goCryptoBot is a bot that automatically trades cryptocurrencies on the Binance.com exchange using the API.
The current version only allows trading on the Margin
account.
The bot supports opening long and short positions.
Bot was tested in the version 1.18.2 of Go.
% go version
Binance API Key
with restrictions set to:
% git clone https://github.com/hubov/gocryptobot
% cd gocryptobot
Your bot configuration needs to be in config/config.json
Config file template below:
{
"exchange": "binance",
"account": "margin",
"host": "https://api.binance.com",
"api_key": "",
"api_secret": "",
"trade": {
"base_symbol": "",
"quote_symbol": "",
"interval": ""
}
}
You need to provide information regarding your account and the pair intend to trade. Below is an example setup for the BTC/USDT
pair traded in 15 minute intervals.
{
"exchange": "binance",
"account": "margin",
"host": "https://api.binance.com",
"api_key": "PUT_YOUR_API_KEY_HERE",
"api_secret": "PUT_YOUR_SECRET_HERE",
"trade": {
"base_symbol": "BTC",
"quote_symbol": "USDT",
"interval": "15m"
}
}
The intervals available at Binance are the following:
m -> minutes; h -> hours; d -> days; w -> weeks; M -> Month
% go run bot.go
You can test your strategy using the trading simulation.
% go run bot.go --sim=1
You can perform the simulation for a specific time period. Date format: YYYY-MM-DD
, time format: YYYY-MM-DD HH:ii:ss
.
% go run bot.go --sim=1 start="2022-05-01" end="2022-05-31"
You can manually trigger an open or close position using the following parameters:
order short
to place a SHORT orderorder long
to place a LONG orderclose short
to close a SHORT positionclose long
to close a LONG positionexit short
to exit a SHORT positionexit long
to exit a LONG positionThe forced order is placed on your real trading account so it will affect your wallet.
% go run bot.go --signal="order long"
You can run the bot as a Linux service to keep it running even after closing the terminal.
% cd /etc/systemd/system
Create a file named: gocryptobot.service
[Unit]
Description=goCryptoBot
[Service]
User=
[Install] WantedBy=multi-user.target
3. Reload daemon
% sudo systemctl daemon-reload
4. Start your service
% sudo systemctl start gocryptobot.service
5. Check status
% sudo systemctl status gocryptobot.service
6. Enable new service on every reboot
% sudo systemctl enable gocryptobot.service
## Mechanics
### Trading
**LONG**
Long positions are always taken using the total value of the quote currency (second in the currency pair). When you close a position, all of the base currency (the first currency in the currency pair) is sold.
>If you are trading the BTC/USDT pair and you have 100 USDT on your account. After meeting the purchase conditions, the bot will place an order for BTC worth 100 USDT. After the sale condition is met, it will sell all of its BTC for USDT.
**SHORT**
To open a short position, a loan is taken with a value corresponding to the quote currency held (the second in the currency pair).
>You trade BTC/USDT with 100 USDT in your account. If the condition for opening a short position is met, the bot will automatically borrow BTC for 100 USDT and open the position.
If the condition to close the short position is met, the bot will buy BTC of the loan amount and automatically pay it back.
### Strategy
The trading strategy is set in `Strategy.go`
There are 8 functions required to implement a strategy and make decisions about opening and closing positions.
`GetData()` is responsible for getting data that the strategy requires
`Calculate()` is responsible for performing calculations on the data obtained from the `GetData()`
**Open position**
`SignalOrderLong()` evaluates whether the conditions for opening a long position are met.
`SignalOrderShort()` corresponds to the function above, but in the context of a short position.
**Close position**
`SignalCloseLong()` evaluates whether the conditions for closing a long position are met.
`SignalCloseShort()` is the equivalent of the above function for short position
The results of the above functions affect the bot's activities only in the intervals set for the bot. For example, once every 15 minutes.
**Exit position** (stop limit/stop loss)
There are two special functions that can trigger a position close if their conditions are met, regardless of the bot's trading interval. They perform the functions of `stop limit` and` stop loss`. They are called up every minute.
`SignalExitLong()` closes a long position if its conditions are met.
`SignalExitShort()` is the short position equivalent of the above function
### Default strategy
The bot has an implemented simple strategy based on:
- Simple Moving Average (SMA)
- Pivot Points (PP)
- Relative Strength Index (RSI)
- Stop limit: 10%
- Stop loss: 5%
You can adjust it according to your needs or completely change it in `Strategy.go`
### Indicators
The bot uses the [Indicator](https://github.com/cinar/indicator) package with a wide selection of trading indicators ready to be used in goCryptoBot's strategies. You can also add your own in the function `Calculate()`
## Upgrading the bot
git pull origin
## Disclaimer
This document and software **do not encourage** you to invest in or trade digital currencies. This is **not an investment advice**.
Using this software may only take place **at your own risk**.
The user of the software is aware that its use **may lead to the loss** of some or all of the funds involved. The author of the software takes **no responsibility for any losses** incurred as a result of the operation of the software.
The author of the script cannot be held responsible for any misuse of the script.