Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rodrigo-brito/ninjabot
A fast trading bot platform for cryptocurrency in Go (Binance)
https://github.com/rodrigo-brito/ninjabot
binance bitcoin bot crypto cryptocurrency go golang hacktoberfest trading trading-bot trading-strategies
Last synced: 1 day ago
JSON representation
A fast trading bot platform for cryptocurrency in Go (Binance)
- Host: GitHub
- URL: https://github.com/rodrigo-brito/ninjabot
- Owner: rodrigo-brito
- License: mit
- Created: 2021-04-24T14:07:55.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-12-01T23:10:30.000Z (11 days ago)
- Last Synced: 2024-12-05T04:05:05.514Z (8 days ago)
- Topics: binance, bitcoin, bot, crypto, cryptocurrency, go, golang, hacktoberfest, trading, trading-bot, trading-strategies
- Language: Go
- Homepage: https://rodrigo-brito.github.io/ninjabot/
- Size: 3.08 MB
- Stars: 1,418
- Watchers: 21
- Forks: 176
- Open Issues: 16
-
Metadata Files:
- Readme: readme.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-golang-repositories - ninjabot
README
[](https://github.com/rodrigo-brito/ninjabot/actions/workflows/ci.yaml)
[](https://codecov.io/gh/rodrigo-brito/ninjabot)
[](https://pkg.go.dev/github.com/rodrigo-brito/ninjabot)
[](https://discord.gg/TGCrUH972E)
[](https://www.patreon.com/ninjabot_github)
A fast cryptocurrency trading bot framework implemented in Go. Ninjabot permits users to create and test custom strategies for sport and future 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](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](https://github.com/rodrigo-brito/ninjabot/releases)
- Or with `go install github.com/rodrigo-brito/ninjabot/cmd/ninjabot@latest`
**Example of usage**
```bash
# 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](examples) directory:
```
go run examples/backtesting/main.go
```
Output:
```
INFO[2023-03-25 13:54] [SETUP] Using paper wallet
INFO[2023-03-25 13:54] [SETUP] Initial Portfolio = 10000.000000 USDT
---------+--------+-----+------+--------+--------+-----+----------+-----------+
| PAIR | TRADES | WIN | LOSS | % WIN | PAYOFF | SQN | PROFIT | VOLUME |
+---------+--------+-----+------+--------+--------+-----+----------+-----------+
| ETHUSDT | 9 | 6 | 3 | 66.7 % | 3.407 | 1.3 | 21748.41 | 407769.64 |
| BTCUSDT | 14 | 6 | 8 | 42.9 % | 5.929 | 1.5 | 13511.66 | 448030.05 |
+---------+--------+-----+------+--------+--------+-----+----------+-----------+
| TOTAL | 23 | 12 | 11 | 52.2 % | 4.942 | 1.4 | 35260.07 | 855799.68 |
+---------+--------+-----+------+--------+--------+-----+----------+-----------+
-- FINAL WALLET --
0.0000 BTC = 0.0000 USDT
0.0000 ETH = 0.0000 USDT
45260.0735 USDT
----- RETURNS -----
START PORTFOLIO = 10000.00 USDT
FINAL PORTFOLIO = 45260.07 USDT
GROSS PROFIT = 35260.073493 USDT (352.60%)
MARKET CHANGE (B&H) = 407.09%
------ RISK -------
MAX DRAWDOWN = -11.76 %
------ VOLUME -----
BTCUSDT = 448030.05 USDT
ETHUSDT = 407769.64 USDT
TOTAL = 855799.68 USDT
-------------------
Chart available at http://localhost:8080
```
### Plot result
### Features
| | Binance Spot | Binance Futures |
|-------------------- |-------------- |-------------------|
| Order Market | :ok: | :ok: |
| Order Market Quote | :ok: | |
| Order Limit | :ok: | :ok: |
| Order Stop | :ok: | :ok: |
| Order OCO | :ok: | |
| Backtesting | :ok: | :ok: |
- [x] Backtesting
- [x] Paper Wallet (Live Trading with fake wallet)
- [x] Load Feed from CSV
- [x] Order Limit, Market, Stop Limit, OCO
- [x] Bot Utilities
- [x] CLI to download historical data
- [x] Plot (Candles + Sell / Buy orders, Indicators)
- [x] Telegram Controller (Status, Buy, Sell, and Notification)
- [x] Heikin Ashi candle type support
- [x] Trailing stop tool
- [x] In app order scheduler
# Roadmap
- [ ] Include Web UI Controller
- [ ] Include more chart indicators - [Details](https://github.com/rodrigo-brito/ninjabot/issues/110)
### Exchanges
Currently, we only support [Binance](https://www.binance.com/en?ref=35723227) 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](./pkg/exchange) directory.
### Support the project
| | Address |
| --- | --- |
|**BTC** | `bc1qpk6yqju6rkz33ntzj8kuepmynmztzydmec2zm4`|
|**ETH** | `0x2226FFe4aBD2Afa84bf7222C2b17BBC65F64555A` |
|**LTC** | `ltc1qj2n9r4yfsm5dnsmmtzhgj8qcj8fjpcvgkd9v3j` |
**Patreon**: https://www.patreon.com/ninjabot_github