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/

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

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