GBot Trader

This app is working with server maintenance.

Exchange

• Poloniex
• Exmo
• Bitfinex
• Liqui
• Dsx
• Binance (Unofficial)
• Cex (Unofficial)
• Cryptopia (Unofficial)
• Kraken (Unofficial)
• Yobit (Unofficial)
• Huobi (Unofficial)
• Kucoin (Unofficial)
• Hitbtc (Unofficial)
• Stex (Unofficial)
• Bleutrade (Unofficial)

Unofficial

• The module on the exchange Unofficial is purchased separately from third-party developers! Telegram - @solvento.
• The modules are running in the DEMO mode does not require a license.

Full version in Russian documentation

README RU

FAQ

Before asking questions, please read the FAQ RU. Most of the answers you will find in it.

Install

1. Install node.js or use hosting (heroku, pivotal, UltraVDS, Zomro and etc.)

2. Copy the repository and install the dependency packages:

$ git clone https://github.com/steeply/gbot-trader.git
$ cd gbot-trader
$ npm i

Setting

Telegram. Creating a new bot

If you use the option TELEGRAM_OFF, then this paragraph is not necessary.

@BotFather

Use the /newbot command to create a new bot. The BotFather will ask you for a name and username, then generate an authorization token for your new bot.
The name of your bot is displayed in contact details and elsewhere.
The Username is a short name, to be used in mentions and telegram.me links. Usernames are 5-32 characters long and are case insensitive, but may only include Latin characters, numbers, and underscores. Your bot's username must end in ‘bot’, e.g. ‘trade_bot’ or ‘TradeBot’.
The token is a string along the lines of 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw that is required to authorize the bot and send requests to the Bot API.

The receipt of Telegram ID

1. Set the parameters API Exchange: EXCHANGE, KEY, SECRET and TELEGRAM_TOKEN.
2. Run GBot Trader.
3. Write your Telegram bot (which you created earlier using @BotFather) any message, you will receive your id number.
4. Turn Off GBot Trader.
5. Set the parameters TELEGRAM_ID.

Parameters variable environment:

Required parameters

Option	Description	Type	Default
KEY	API key	string	-
SECRET	API secret	string	-
NAME_COIN	Trading currency	string	ltc
NAME_COIN_TWO	Trading currency	string	usd
EXCHANGE	The choice of the exchange poloniex (inverted pairs) bittrex (inverted pairs) exmo bitfinex liqui dsx	string	-
EXCHANGE_HOST	Host exchange API. If the primary host is not available.	string	-

Parameters for Telegram

Option	Description	Type	Default
TELEGRAM_TOKEN	Telegram token	string	-
TELEGRAM_ID	Your User ID Telegram	number	-
SOCKS5_HOST	HOST SOCKS5	string	-
SOCKS5_PORT	PORT SOCKS5	number	1080
SOCKS5_USERNAME	Username SOCKS5	string	-
SOCKS5_PASSWORD	Password SOCKS5	string	-
TELEGRAM_BASEURL	URL server and proxy	string	-
TELEGRAM_OFF	Disable Telegram	boolean	false

Option TELEGRAM_OFF disables the ability to use Telegram in the bot. All management and all notifications sent via Telegram are the same are disabled!

By default, the bot will work at default settings. You can change them using the following options.

Used trade options

Option	Description	Type	Default
TIME_UPDATE_AUTO_SETTINGS	Interval update of auto settings (min)	number	2
DEPOSIT_LIMIT	Deposit consuming percent or the absolute number If an absolute number is specified: the size of the used part of the Deposit in the currency NAME_COIN_TWO. For exchanges with inverted currency in the currency of the parameter NAME_COIN	number or string	100%
DEPOSIT_TYPE	The option of returning the deposit to the bot's balance for a profit order. reserve - settlement with reservation. straight - direct from the exchange (FAQ п.19)	string	reserve
PERMANENT_DEPOSIT	Use the total deposit calculation together with the trades history	boolean	false
COUNT_ORDERS	Quantity all orders. How many will be installed.	number	Calculated based on deposit amount
QUANTITY_ORDERS_IN_BLOCKS	Quantity orders in blocks How many orders will be simultaneously on the market.	number	0
HOLD_QUANTITY_ORDERS	To hold a given number of orders in QUANTITY_ORDERS_IN_BLOCKS (FAQ п.22)	boolean	true
GREEDY_FIRST_ORDER_SIZE	Size of the "zero" order in the traded currency or percentage Format: 0.1 or 5%	number or string	0
GREEDY_FIRST_ORDER_SIZE_INSECOND_CURRENCY	Size of the "zero" order in the base currency	number	0
SIZE_FIRST_ORDERS	The size of the first order in the currency being traded or in percent Example: 0.1 or 5%	string	0
SIZE_FIRST_ORDERS_INSECOND_CURRENCY	The size of the first order in the base currency	number	0
SIZE_ORDERS_FROM_DEPOSIT	Order size as a percentage of the remaining deposit	number	0
SIZE_ORDERS_MARTINGALE	The size of the orders for Martingale (for Exponential - %, Linear - absolute number) Example: 0.1 or 5%	string or number	0
TYPE_ORDERS_MARTINGALE	The type of increase in the Martingale. add - summation, multiply - multiplication, pow - exponentiation	string	add
CONTINUE_MARTINGALE_GRID	To continue the grid Martingale when you restart the bot (saves the order size)	boolean	false
TRADING_PRICE_RANGE	Price range allowed for bidding, absolute numbers or percentages. Example: 3000/5000 10%/20% 10% 1000/10% If not specified, no restrictions	string	-
TRADING_PRICE_RANGE_OTHER	Range of prices, another currency pair allowed for trading, absolute numbers or percentages. Example: 3000/5000 10%/20% 10% 1000/10% If not specified, no restrictions	string	-
OTHER_PAIR	Currency pair to monitor the price range. Specified as well as on the exchange. Example: btc/usd	string	-
IGNORE_ORDERS_AT_START	Ignore the previously set orders at the start / restart of the bot	boolean	false
DELAY_TIME_CYCLES	Delay in seconds before starting a new cycle * for One orders: after execution of a profit order * for Scalper: after TIME_CLOSE_ORDERS	number	0
STOP_LOSS_ABS	Absolute price value for Stop Loss (FAQ п.53)	number	0
BUY_STOP_ABS	Absolute price value for Buy Stop (FAQ п.53)	number	0
STOP_LOSS_FLOATING	Percentage of price drop from High price to trigger a floating Stop Loss	number	0

Important!

The size of the order for SIZE_FIRST_ORDERS_INSECOND_CURRENCY will be calculated by the formula SIZE_FIRST_ORDERS_INSECOND_CURRENCY / price

SIZE_FIRST_ORDERS or SIZE_FIRST_ORDERS_INSECOND_CURRENCY select only 1 of the parameters!

GREEDY_FIRST_ORDER_SIZE or GREEDY_FIRST_ORDER_SIZE_INSECOND_CURRENCY select only 1 of the parameters!

SIZE_ORDERS_MARTINGALE or SIZE_ORDERS_FROM_DEPOSIT select only 1 of the parameters!

With the manual size of the first order RANGE_OFFSET does not work, and COUNT_ORDERS will be calculated automatically.

If SIZE_ORDER_MARTINGALE is set as a percentage, then TYPE_ORDER_MARTINGALE is not applied.

Offset orders

The possible indentation of the orders. Select one of the offered.

Option	Description	Type	Default
FIX_PRICE_FIRST_ORDER	Fixed price of the first order	number	0
OFFSET_FIRST_ORDERS_PERCENT	Position difference of the first order in %	number	0
OFFSET_FIRST_ORDERS_POINTS	Position difference of the first order in points	number	0
OFFSET_ORDERS_POINTS	Position difference between orders in points	number	10
OFFSET_ORDERS_PERCENT	Position difference between orders in %	number	0
OFFSET_ORDERS_EXPONENTIAL	Position difference between orders is exponentially in %	number	0
OFFSET_ORDERS_MULTIPLY	Offset for orders by multiplier	number	0
OFFSET_ORDERS_BLOCK	Position difference between orders is blocks in % For example, in the first block orders will be indented 0.2, in the second block 0.4, etc.	number	0
RANGE_OFFSET	Range offset	number	0

Parameter OFFSET_FIRST_ORDERS_PERCENT or OFFSET_FIRST_ORDERS_POINTS can be used in conjunction with any of the selected options.

To set the first order in the market, use OFFSET_FIRST_ORDERS_PERCENT=-1.

To limit the maximum indentation for OFFSET_ORDERS_EXPONENTIAL use setting OFFSET_ORDERS_EXPONENTIAL_MAX. Important! OFFSET_ORDERS_EXPONENTIAL_MAX should be more than OFFSET_ORDERS_EXPONENTIAL.

Disable orders grid

Option	Description	Type	Default
DISABLE_GRID_SELL	Disable order placement on the grid for Sell orders	boolean	false
DISABLE_GRID_BUY	Disable order placement on the grid for Buy orders	boolean	false

Modules AutoConfig

Option	Description	Type	Default
DANGER_PRICE_STOP	Bot stopping according to the price spike	boolean	false
DANGER_PRICE_STOP_PERCENT	The percentage of the price spike for the bot stopping	number	9
DYNAMIC_SETTINGS_TIME	Dynamic time updating for auto options	boolean	false
DYNAMIC_OFFSET_ORDERS	Dynamic order allocation	boolean	false
DYNAMIC_OFFSET_INTERVAL	The price check interval for the dynamic grid (in minutes)	number	60
DYNAMIC_OFFSET_PROFIT_DIVISOR	The divisor of the change of the profitable order	number	10
DYNAMIC_OFFSET_INDENTION_DIVISOR	Dividing the grid size	number	COUNT_ORDERS
TREND_DEFINITION	Trend determination (Experimentally)	boolean	false
ABRUPT_CHANGE_TREND	Rapid trend reversal (Experimentally)	boolean	false
OFF_MODULES_AUTO_SETTINGS	Disabling all Autotune Modules	boolean	false

Options TREND_DEFINITION ABRUPT_CHANGE_TREND only for strategy Scalper.

The option OFF_MODULES_AUTO_SETTINGS controls DANGER_PRICE_STOP, DYNAMIC_SETTINGS_TIME, DYNAMIC_OFFSET_ORDERS, TREND_DEFINITION, ABRUPT_CHANGE_TREND

Individual parameters strategies

All the strategies are mutually exclusive. If no strategy is selected, use the strategy of "Scalper".

Strategy "Scalper" and "Bollinger Bands"

Option	Description	Type	Default
TIME_CLOSE_ORDERS	Closing time of unused orders (min)	number	5
TIME_CLOSE_ORDERS_INACTIVITY	Closing time of undemanded orders (min)	number	15

Strategy "Scalper"

Option	Description	Type	Default
TYPE_SCALPER	Scalper type of work. Value: 1 or 2	number	1
STEP_BREAKEVEN_PERCENT	Only for TYPE_SCALPER=1 Percentage of breakeven	number	50
TRADING_AMOUNT_RANGE	Range of random order size Values are specified in the format start/end of the range.	string	-

When using TRADING_AMOUNT_RANGE, the parameters COUNT_ORDERS, SIZE_ORDERS_MARTINGALE, SIZE_FIRST_ORDERS_*, etc. do not make sense and will be ignored.

Strategy "Bollinger Bands"

Option	Description	Type	Default
BBANDS	Bollinger Bands (Trend strategy!)	boolean	false
BBANDS_DEVIATION	Deviation	number	2
BBANDS_PERIOD	Period BBANDS	number	20
RSI_TYPE	rsi or stochrsi	string	rsi
RSI_PERIOD	Period RSI	number	14
RSI_RANGE_SELL	RSI range for sell Values are specified in the format start/end of the range.	string	70/100
RSI_RANGE_BUY	RSI range for buy	string	1/30
TIMEFRAME	Time-frame. Interval of interrogation of the prices (minutes)	number	1
CLOSE_GRID_OPPOSITE	Closes the opposite orders grid	boolean	false
CLOSE_GRID_IS_TRADING_SIGNAL_CANCELED	Closes the grid of orders when the signal is canceled	boolean	false
SAVE_PRICE_FILE	Save price cache to a file	boolean	false
PRICE_FILE_PATH	A custom path to the directory with the file	string	Folder with bot

If RSI_PERIOD = 0, then the indicator is disabled and trading occurs only on the BBANDS indicator!

If you use the SAVE_PRICE_FILE option, you need write access to the directory. Note that if you run the bot and the real market prices are different from those in the file, the original orders may get wrong and sell at a loss!

The parameter SAVE_PRICE_FILE will not work on PaaS platforms (Heroku, Pivotal and any other platforms where container virtualization tools are used)!

If the default bbands is used without external indicators, then orders are placed not on the bid and ask of the market, but on the borders of the bbands lines, respectively, the offset of the first order are also calculated from these values

Strategy "One Orders"

When you start the strategy of "Sell One, Buy a lot" the initial state of the balance of the base currency in the pair is ignored!

Option	Description	Type	Default
ONE_ORDERS_SELL	Strategy: "One Sell a lot Buy"	boolean	false
ONE_ORDERS_BUY	Strategy: "One Buy a lot Sell"	boolean	false
ONE_ORDERS_OFFSET	The difference between LastPrice and first order in the stack of orders in %. Will pull the order, if this value is exceeded.	number	2
ONE_ORDERS_PROFIT_PERCENT	Specifies the percentage desired profit May take a fixed value, and range min/max	string or number	1
ONE_ORDERS_SPO_PERCENT	Sets the percentage of the desired profit when the price jumps. (delay before launch) (FAQ п.61)	string/number	0
INTEGRITY_CONTROL_ORDERS	Integrity control orders (soft or hard)	string	soft
TYPE_DATA_USED	Where to get information about the used orders: active - active orders history - active orders + trading history	string	active
FIRST_LOADING_HISTORY	Download the history when you start the bot	boolean	false
NUMBER_ROWS_LOAD_HISTORY	Number of rows to load history	number	100
LOAD_HISTORY_DAYS	The number of days of history While only used for Poloniex	number	30
SAVE_HISTORY	Save a copy of history to your computer	boolean	false
CYCLES_AUTO_EXIT	How many cycles to make the exit	number	0
AUTO_EXIT_PERCENT	How much percentage should the price move away from the last profit of the order to complete the current cycle. (FAQ п.62)	number	0
STOP_LOSS_PERCENT	Stop Loss percentage	number	0
STOP_LOSS_DEPOSIT_LIMIT	Percentage of the deposit balance to trigger Stop Loss	number	0
BUY_STOP_PERCENT	Buy Stop percentage	number	0
TRAILING_STOP_PERCENT	Trailing stop percentage	number	0
TRAILING_STOP_PROTECTIVE_SPREAD	Sets the percentage of additional deviation of the bid price from the price that initiated the bid	number	0
TRAILING_GRID_PERCENT	Trailing grid percentage	number	0
DISABLE_CAPITALIZATION	Disable capitalization in profit order	boolean	false
CAPITALIZATION_BUY_ORDER	Includes partial capitalization of Buy orders in DISABLE_CAPITALIZATION	boolean	false
PARTIALLY_EXECUTED_GRID	Take into account partial execution of orders from the grid Only for DISABLE_CAPITALIZATION=true	boolean	false
SHIFT_GRID_PARTIAL_EXECUTION	Allow shifting the grid of orders if there is partial execution of orders from the grid	boolean	false
STRATEGY_AUTO_REVERS	Auto switching strategy to reverse	boolean	false
OFFSET_LAST_ORDER_PERCENT	The percentage of the price distance from the last order to enable auto-switching of strategy	number	5
PRICE_TRADING_TYPE_CHANGE	Price at which the trade type will change (Absolute value and percentage) Format: number or low/high Example: 3000 3000/5000 10%/20% 10% 1000/10% (FAQ п.58)	number or string	-

If the parameter INTEGRITY_CONTROL_ORDERS in hard mode, then a sell order will be installed only if the volume installed and executed buy orders will be the same.

If the parameter FIRST_LOADING_HISTORY included, will be loaded into the cache the first NUMBER_ROWS_LOAD_HISTORY BUY orders before the first SELL order for the selected pair and put a SELL order on the basis of these data.

Option DISABLE_CAPITALIZATION=true activates INTEGRITY_CONTROL_ORDERS on hard.

Additional options

Notifications

Option	Description	Type	Default
NOTIFICATION_PAIR	Notification pair of rate changing (For example: btc/usd, ltc/usd or all/all for all pair)	string	-
NOTIFICATION_DEVIATION_PERCENT	In what percentage should the price spike for the notification to work	number	5
MONITORING_PAIR	Pairs for monitoring. (For example: btc/usd, ltc/usd, or just a pair currency, for example: btc). If none of that is set, ALL available pairs will be monitored on the exchange.	string	All pairs
NOTIFICATION_ERROR_COUNT	The number of errors in 5 minutes for notification	number	0
NOTIFICATION_ORDER_IS_EXECUTED	Notice of execution of one orders	boolean	false
NOTIFICATION_END_GRID	Notification of the end of the order grid. Notification will be sent if there are less than 3 orders left	boolean	false

Log

Option	Description	Type	Default
LOG	Calculating log output of auto settings	boolean	false
LOG_DEBUG	The output of the debug log	boolean	false
LOG_TRANSPORTS	Where to write the log: 0 - console 1 - file 2 - console and file	number	0
LOG_PATH	A custom path to the directory with the log	string	Folder with bot
LOG_TREE	Save logs by directory year/month/day	boolean	false

Error processing

Option	Description	Type	Default
NUMBER_CHECK_DATA	How many times to check the data. Use the value 2 or more. 0 - off	number	0
AUTO_RESTART_HANGING	Auto-restart of the worker in case of his hangup (error message: "Worker does not meet" )	boolean	true
RESTART_TRADER_TIME	How many seconds to wait before re-querying the data after network errors	number	5

Other parameters

Option	Description	Type	Default
TIME_ZONE	Time zone Database Time Zones	string	Asia/Yekaterinburg
EXCHANGE_FEE	The Commission for transactions of the exchange	number	0.25
DELAY_REQUEST_API	The delay of requests to the API in milliseconds	number	200
DELAY_BETWEEN_MODULES	Then delay in seconds between execution of consecutive modules.	number	3
TITLE	The title of the console window.	string	GBot
LANGUAGE	The language of the interface (ru or en)	string	ru
NODE_ENV	Value production activate: 1. error notifications by E-mail. 2. prohibits the use of conf-dev.js. 3. disabling colors in logs. 4. disables TITLE	string	dev
BOT_TRADE	Allow trading	boolean	true
URL_STATISTICS	URL of the server where the statistics will be sent in post json format	string	-
REPEAT_COMMAND_ACTION	Will duplicate command to install/re-opening to fully execute the commands /sell_all, /buy_all, stop_loss, etc	boolean	false
SAVE_STATE	Saves the internal state to a file at shutdown. When restarting, it is restored from the file, ignoring the first stage of initialization and skipping all the initial calculations	boolean	false
SAVE_STATE_PATH	The path to save SAVE_STATE	string	Folder with bot
TIME_SESSION	Session time. Format startTime/endTime (FAQ 63)	string	-
HIDE_SECRET_KEY	Hides private keys when transferring to the web api	boolean	false

Important:

• If you've changed LANGUAGE send a command /start in Telegram bot for a new language initialization in Telegram

The settings for the DEMO module.

To enable the Demo module and emulate the trades select the option EXCHANGE=demo.

Option	Description	Type	Default
DEMO_EXCHANGE	The choice of the exchange to emulate	string	-
BALANCE_COIN	Virtual balance of the first coin	number	-
BALANCE_COIN_TWO	The virtual balance of the second coin	number	-

Run

$ npm start

For Windows

Create a start.bat file, specify the necessary parameters in it and run this file.

SET TELEGRAM_TOKEN=110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw 
SET TELEGRAM_ID=12345678

SET DEPOSIT_LIMIT=80%%

....

npm start
pause

Attention!

The percentages settings for Windows are specified by a double percent sign (%%)

For Linux and Mac

Create a start.sh file, specify the necessary parameters in it and run this file.

export TELEGRAM_TOKEN=110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw 
export TELEGRAM_ID=12345678

export DEPOSIT_LIMIT=80%

...

node ./build/server

For Heroku

heroku ps:scale web=0
heroku ps:scale worker=1

To launch the control panel in a Telegram, send a message to:

/start

Additional commands in Telegram:

/info               - list of all commands

/version            - The version of the bot
/params             - Parameters which can be changed via Telegram
/params_no_comment
/martin [cache]     - A theoretical calculation of the orders of the martingale (parameters are taken from config)
/ticker coin_name   - Shows a quote of a pair coin_name
/trade              - Switches to the specified trading pair
/stop [codeExit]    - The application shutsdown. codeExit - an optional exit code.
/sell_all           - Sell on the market immediately. (Attention: The sale will be made without confirmation!)
/buy_all            - Buy on the market immediately. (Attention: The buy will be made without confirmation!)
/restart            - Restart GBot Trader
/stats              - Trading statistics
/note [ignore text] - The text in this line will be ignored. It can be used as a comment.
/stoplossfloating   - Displays Stop Loss Floating information
/stoploss           - Displays StopLoss information
/buystop            - Displays BuyStop information
/trail              - Displays Trailing Stop information
/trail_grid         - Displays Trailing Grid information
/getbalance         - Displays the start balance
/setbalance number  - Sets the starting balance
/addbalance number  - Add coins to the starting balance

Payment

BTC: 1AMmeM2ERD6nd1K1y5Zta2BvfugHt5UjPo

LTC: LTSkBKFN6i1oy8pnBdpAR71xJTt9UU51sH