一款用 Go 语言实现的快速加密货币交易机器人框架。Ninjabot 允许用户为现货和期货市场创建并测试自定义策略。

文档：https://rodrigo-brito.github.io/ninjabot/

免责声明
本软件仅用于教育目的。请勿使用您无法承受损失的资金。使用本软件的风险由您自行承担。作者及所有关联方对您的交易结果不承担任何责任。

安装

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

使用示例

请查看 examples 目录：

• 模拟钱包（实时模拟）
• 回测（基于历史数据的模拟）
• 实盘账户（币安）

CLI

要下载历史数据，您可以从以下途径获取 Ninjabot 的 CLI 工具：

• 在 release 页面 下载预编译的二进制文件
• 或者使用 go install github.com/rodrigo-brito/ninjabot/cmd/ninjabot@latest

使用示例

# 下载 BTCUSDT 的 K 线数据到 btc.csv 文件中（最近 30 天，1 日线）
ninjabot download --pair BTCUSDT --timeframe 1d --days 30 --output ./btc.csv

回测示例

• 运行 examples 目录下的自定义策略回测：

go run examples/backtesting/main.go

输出：

INFO[2023-03-25 13:54] [SETUP] 使用模拟钱包                   
INFO[2023-03-25 13:54] [SETUP] 初始资金 = 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 |
+---------+--------+-----+------+--------+--------+-----+----------+-----------+

-- 最终资金 --
0.0000 BTC = 0.0000 USDT
0.0000 ETH = 0.0000 USDT
45260.0735 USDT

----- 收益 -----
初始资金     = 10000.00 USDT
最终资金     = 45260.07 USDT
总利润        =  35260.073493 USDT (352.60%)
市场涨幅 (持币不动) =  407.09%

------ 风险 -------
最大回撤 = -11.76 %

------ 交易量 -----
BTCUSDT         = 448030.05 USDT
ETHUSDT         = 407769.64 USDT
总计           = 855799.68 USDT
-------------------
图表可在 http://localhost:8080 查看

绘制结果

功能特性

| | 币安现货 | 币安期货 | |-------------------- |-------------- |-------------------| | 市价单 | :ok: | :ok: | | 市价挂单 | :ok: | | | 限价单 | :ok: | :ok: | | 止损单 | :ok: | :ok: | | OCO 订单 | :ok: | | | 回测 | :ok: | :ok: |

• 回测

  • 模拟钱包（使用虚拟资金进行实时交易）
  • 从 CSV 文件加载行情数据
  • 支持限价单、市价单、止损单、OCO 订单

• 机器人工具

  • CLI 工具用于下载历史数据
  • 图表绘制功能（K 线、买卖订单、指标）
  • Telegram 控制器（状态、买入、卖出及通知）
  • 支持 Heikin Ashi K 线类型
  • 尾随止损工具
  • 应用内订单调度器

路线图

• 添加 Web UI 控制器
• 增加更多图表指标 - 详情

交易所支持

目前我们仅支持 币安 交易所。如果您希望添加对其他交易所的支持，您需要实现一个新的 struct，该结构体需满足 Exchange 接口的要求。您可以在 exchange 目录中找到一些示例。

支持本项目

	地址
BTC	bc1qpk6yqju6rkz33ntzj8kuepmynmztzydmec2zm4
ETH	0x2226FFe4aBD2Afa84bf7222C2b17BBC65F64555A
LTC	ltc1qj2n9r4yfsm5dnsmmtzhgj8qcj8fjpcvgkd9v3j

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

Ninjabot 快速上手指南

Ninjabot 是一个用 Go 语言编写的高性能加密货币交易机器人框架，支持现货和合约市场的策略创建、回测及实盘交易（目前仅支持币安交易所）。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS 或 Windows
• Go 语言环境：需安装 Go 1.16 或更高版本。
  • 国内用户推荐使用清华或阿里镜像加速下载：https://golang.google.cn/dl/
  • 配置国内代理以加速模块下载：

    export GOPROXY=https://goproxy.cn,direct
    

• 交易所账户：拥有 Binance（币安）账户及 API Key（用于实盘或获取历史数据）。

安装步骤

1. 安装核心库

使用 go get 命令安装 Ninjabot 及其依赖：

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

2. 安装 CLI 工具（可选但推荐）

为了方便下载历史数据进行回测，建议安装命令行工具：

go install github.com/rodrigo-brito/ninjabot/cmd/ninjabot@latest

注意：确保 $GOPATH/bin 已添加到您的系统环境变量 PATH 中，以便直接在终端运行 ninjabot 命令。

或者，您也可以直接从 Release 页面 下载预编译的二进制文件。

基本使用

场景一：下载历史数据

使用 CLI 工具下载指定交易对的历史 K 线数据（CSV 格式），用于回测。

示例：下载 BTCUSDT 过去 30 天、日线级别的数据

ninjabot download --pair BTCUSDT --timeframe 1d --days 30 --output ./btc.csv

场景二：运行策略回测

Ninjabot 提供了示例代码供快速测试。您可以直接运行官方提供的回测示例来验证环境并查看结果。

执行回测命令：

go run examples/backtesting/main.go

预期输出： 运行成功后，终端将显示详细的交易统计信息（如胜率、净利润、最大回撤等），并在本地启动一个 Web 服务用于可视化图表。

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 --
45260.0735 USDT

------ RETURNS -----
START PORTFOLIO     = 10000.00 USDT
FINAL PORTFOLIO     = 45260.07 USDT
GROSS PROFIT        =  35260.073493 USDT (352.60%)

Chart available at http://localhost:8080

访问 http://localhost:8080 即可查看包含买卖点和指标的策略走势图。

风险提示：本软件仅供教育和研究用途。加密货币交易存在高风险，请使用您能承受损失的资金，并自行承担所有交易风险。