A fast cryptocurrency trading bot framework implemented in Go. Ninjabot permits users to create and test custom strategies for spot markets.

Docs: https://rodrigo-brito.github.io/ninjabot/

DISCLAIMER
This software is for educational purposes only. Do not risk money which you are afraid to lose. USE THE SOFTWARE AT YOUR OWN RISK. THE AUTHORS AND ALL AFFILIATES ASSUME NO RESPONSIBILITY FOR YOUR TRADING RESULTS

Installation

go get -u github.com/rodrigo-brito/ninjabot/...

Examples of Usage

Check examples directory:

• Paper Wallet (Live Simulation)
• Backtesting (Simulation with historical data)
• Real Account (Binance)

CLI

To download historical data you can download ninjabot CLI from:

• Pre-build binaries in release page
• Or with go install github.com/rodrigo-brito/ninjabot/cmd/ninjabot@latest

Example of usage

# Download candles of BTCUSDT to btc.csv file (Last 30 days, timeframe 1D)
ninjabot download --pair BTCUSDT --timeframe 1d --days 30 --output ./btc.csv

Backtesting Example

• Backtesting a custom strategy from examples directory:

go run examples/backtesting/main.go

Output:

INFO[2021-10-31 18:13] [SETUP] Using paper wallet                   
INFO[2021-10-31 18:13] [SETUP] Initial Portfolio = 10000.000000 USDT 
+---------+--------+-----+------+--------+--------+----------+-----------+
|  PAIR   | TRADES | WIN | LOSS | % WIN  | PAYOFF |  PROFIT  |  VOLUME   |
+---------+--------+-----+------+--------+--------+----------+-----------+
| BTCUSDT |     14 |   6 |    8 | 42.9 % |  5.929 | 13511.66 | 448030.05 |
| ETHUSDT |      9 |   6 |    3 | 66.7 % |  3.407 | 21748.41 | 407769.64 |
+---------+--------+-----+------+--------+--------+----------+-----------+
|   TOTAL |     23 |  12 |   11 | 52.2 % |  4.942 | 35260.07 | 855799.68 |
+---------+--------+-----+------+--------+--------+----------+-----------+

--------------
WALLET SUMMARY
--------------
0.000000 BTC = 0.000000 USDT
0.000000 ETH = 0.000000 USDT

TRADING VOLUME
BTCUSDT        = 448030.05 USDT
ETHUSDT        = 407769.64 USDT

45260.073493 USDT
--------------
START PORTFOLIO = 10000.00 USDT
FINAL PORTFOLIO = 45260.07 USDT
GROSS PROFIT    =  35260.073493 USDT (352.60%)
MARKET (B&H)    =  407.09%
MAX DRAWDOWN    =  -11.76 %
VOLUME          =  855799.68 USDT
COSTS (0.001*V) =  855.80 USDT (ESTIMATION) 
--------------
Chart available at http://localhost:8080

Plot result:

Features:

• Live Trading

  • Custom Strategy
  • Order Limit, Market, Stop Limit, OCO

• Backtesting

  • Paper Wallet (Live Trading with fake wallet)
  • Load Feed from CSV
  • Order Limit, Market, Stop Limit, OCO

• Bot Utilities

  • CLI to download historical data
  • Plot (Candles + Sell / Buy orders, Indicators)
  • Telegram Controller (Status, Buy, Sell, and Notification)
  • Heikin Ashi candle type support
  • Trailing stop tool
  • In app order scheduler

Roadmap

• Include Web UI Controller
• Include more chart indicators - Details
• Support future market - Details

Exchanges

Currently, we only support Binance exchange. If you want to include support for other exchanges, you need to implement a new struct that implements the interface Exchange. You can check some examples in exchange directory.

Support the project

	Address
BTC	bc1qpk6yqju6rkz33ntzj8kuepmynmztzydmec2zm4
ETH	0x2226FFe4aBD2Afa84bf7222C2b17BBC65F64555A
LTC	ltc1qj2n9r4yfsm5dnsmmtzhgj8qcj8fjpcvgkd9v3j

Patreon: https://www.patreon.com/ninjabot_github