您可从示例策略项目快速开始，也可直接创建新项目。

您无需下载banbot的源代码，而只需创建一个用于管理交易策略的项目，通过go get添加banbot依赖，您即可享受banbot带来的全部便利。

当您在策略项目下执行go build时，您的策略将和banbot源码一起打包为单个可执行文件，您可使用此文件回测、实盘、或启动WebUI等。

环境变量

为方便后续使用，您需要设置环境变量BanDataDir和BanStratDir。

BanDataDir建议设置为一个空目录。是banbot运行过程中回测结果、前端UI资源文件保存的目录。不建议设置为策略项目的子目录。

BanStratDir即您的交易策略项目(banstrats)的路径，每次回测时，banbot会自动保存您此次回测对应的策略代码版本，方便您及时恢复到之前的某个版本。

比如设置环境变量如下：

MacOS

nano ~/.zshrc
# 如果您使用的Catalina以前的版本，请使用nano ~/.bash_profile
# 在文件末尾追加：
export BanDataDir=/Users/YourName/bandata
export BanStratDir=/Users/YourName/banstrats
# 然后Ctrl+O保存，Ctrl+X退出
# 执行下面命令使修改生效
source ~/.zshrc

Linux

nano ~/.bashrc
# 在文件末尾追加：
export BanDataDir=/home/YourName/bandata
export BanStratDir=/home/YourName/banstrats
# 然后Ctrl+O保存，Ctrl+X退出
# 执行下面命令使修改生效
source ~/.bashrc

Windows

BanDataDir=E:\quant\bandata
BanStratDir=E:\quant\banstrats

注意一般修改后需要打开新的终端窗口才会生效。

从示例项目开始(推荐)

示例项目实现了网格策略、经典均线策略等，您可基于此快速实现您的自定义策略。

打开终端，运行以下命令：

# 拉取示例项目代码
git clone https://github.com/banbox/banstrats

cd banstrats
# 初始化依赖
go mod tidy

如果您没有安装git工具，也可直接打开banstrats网页，下载zip压缩包并解压。

TIP

强烈建议您直接使用此示例项目开始

初始化新项目(专家可选)

如果您对banbot没有足够了解，请按照上面指引直接使用示例策略项目。

如您确定创建一个空白的策略项目，可打开终端，输入以下命令：

# mystrats是项目名称，可随意更换
mkdir mystrats
cd mystrats
go mod init mystrats
go get github.com/banbox/banbot

首先我们创建一个ma文件夹，存放均线类策略，在ma中创建demo.go文件，实现我们的第一个简单的均线交叉买卖策略：

package ma

import (
	"github.com/banbox/banbot/config"
	"github.com/banbox/banbot/strat"
	ta "github.com/banbox/banta"
)

func init() {
	// 注册策略到banbot中，后续在配置文件中使用ma:demo即可引用此策略
	// `init`函数是go中的特殊函数，会在当前包被导入时立刻执行
	strat.AddStratGroup("ma", map[string]strat.FuncMakeStrat{
		"demo": Demo,
	})
}

func Demo(pol *config.RunPolicyConfig) *strat.TradeStrat {
	return &strat.TradeStrat{
		WarmupNum: 100,
		OnBar: func(s *strat.StratJob) {
			e := s.Env
			ma5 := ta.SMA(e.Close, 5)
			ma20 := ta.SMA(e.Close, 20)
			maCrx := ta.Cross(ma5, ma20)

			if maCrx == 1 {
				s.OpenOrder(&strat.EnterReq{Tag: "open"})
			} else if maCrx == -1 {
				s.CloseOrders(&strat.ExitReq{Tag: "exit"})
			}
		},
	}
}

然后在项目根目录下创建一个main.go文件，写入以下代码，即完成了入口启动文件配置

package main

import (
	"github.com/banbox/banbot/entry"
	_ "mystrats/ma"
)

func main() {
	entry.RunCmd()
}

风格提示

为保持各类策略的可维护性，我们建议将相似策略放在同一个go package包中，不建议在main.go中直接实现策略。具体目录结构请参考示例策略项目

在进行回测时，banbot会自动备份此次回测的策略源代码，方便追溯不同版本策略的效果。