• English👈
• 中文

BBGO

一个用 Go 语言编写的现代加密货币交易机器人框架。

当前状态

社区

使用 BBGO 可以做什么

交易机器人用户 💁‍♀️ 💁‍♂️

你可以使用 BBGO 运行内置策略。

策略开发者 🥷

你可以利用 BBGO 的交易单元和回测单元来实现自己的策略。

交易单元开发者 🧑‍💻

你可以使用 BBGO 底层的通用交易所 API；目前支持 8 家主流交易所，因此无需重复实现。

特性

• 交易所抽象接口。
• 流式集成（用户数据 WebSocket、市场数据 WebSocket）。
• 通过 WebSocket 实时整合订单簿。
• 支持 TWAP 订单执行。详见 TWAP 订单执行
• 盈亏计算。
• Slack/Telegram 通知。
• 回测：基于 K 线的回测引擎。详见 回测
• 内置参数优化工具。
• 内置网格策略及其他多种内置策略。
• 多交易所会话支持：你可以使用不同账户或子账户连接超过 2 家交易所。
• 指标接口与 pandas.Series 类似（系列）（使用方法)：
  • 累积/分配指标
  • 阿诺·勒古移动平均线
  • 平均真实波幅
  • 布林带
  • 商品通道指数
  • 累计移动平均线
  • 双重指数移动平均线
  • 方向性运动指数
  • 布朗运动漂移因子
  • 动量指标
  • 指数加权移动平均线
  • 赫尔移动平均线
  • 趋势线（工具）
  • 移动平均收敛发散指标
  • 资金流量指数
  • 枢轴点
  • 运行移动平均线
  • 相对强弱指数
  • 简单移动平均线
  • 埃勒斯超级平滑滤波器
  • 随机振荡器
  • 超趋势指标
  • 三重指数移动平均线
  • 蒂尔森 T3 移动平均线
  • 三角移动平均线
  • 可变指数动态平均线
  • 波动率指标
  • 成交量加权平均价格
  • 零延迟指数移动平均线
  • 费雪变换
  • G-H 滤波器（阿尔法-贝塔滤波器）
  • 几何移动平均线
  • 卡尔曼滤波器
  • 克林格振荡器
  • 线性回归
  • 抛物线 SAR
  • 真实强度指数
  • UT 机器人警报
  • 成交量加权移动平均线
  • 加权漂移
  • 韦尔斯·怀尔德移动平均线
  • 标准差
  • ATR 百分比
  • 成交量分布图
  • 以及更多...
• 平均蜡烛 OHLC / 普通 OHLC（请查看 此配置）
• 基于 React 的 Web 控制台。
• 已准备好 Docker 镜像。
• 支持 Kubernetes。
• Helm 图表已准备就绪。
• 高精度浮点数运算（最多 16 位小数，需使用 -tags dnum 参数运行）。

截图

内置策略

策略	描述	类型	回测支持
grid	第一代网格策略，灵活性更高，但需要提前准备库存	做市
grid2	第二代网格策略，可将你的报价资产转化为网格，支持基础币+报价币模式	做市
bollgrid	结合内置布林带指标的基本网格策略	做市
xmaker	跨交易所做市策略，可对冲另一侧的库存风险	做市	无
xdepthmaker	跨交易所基于深度的做市策略	做市	无
xfixedmaker	跨交易所固定价差做市策略	做市	无
xnav	该策略帮助记录当前的净资产值	工具	无
xalign	该策略自动对齐你的余额和仓位	工具	无
xfunding	资金费率收费策略	资金费率	无
autoborrow	该策略利用保证金借入资产，以帮助你维持最低余额	工具	无
autobuy	定期自动买入特定资产	工具	无
pivotshort	该策略寻找枢轴低点，并在价格跌破前低时入场交易	多空
schedule	该策略按固定数量定期买卖，可用作单一DCA，或用于补充如BNB等费用币	工具
irr	该策略根据预测的回报率开仓	多空
bollmaker	该策略持有长期多空头寸，在两侧挂单做市，并使用布林带控制仓位大小	做市
wall	该策略在订单簿上创建一道“墙”（大量订单）	做市	无
scmaker	专为稳定币市场设计的做市策略，如USDC/USDT	做市
drift		多空
rsicross	当快速RSI上穿慢速RSI时开多仓，这是一个使用v2指标的演示策略	多空
emacross	EMA交叉策略	多空
marketcap	该策略根据市值重新平衡投资组合	再平衡	无
supertrend	该策略使用DEMA和超级趋势指标开多空仓	多空
trendtrader	该策略根据趋势线突破开多空仓	多空
elliottwave		多空
ewoDgtrd		多空
fixedmaker		做市
factorzoo		多空
fmaker		做市
linregmaker	基于线性回归的做市策略	做市
liquiditymaker	在订单簿上提供流动性	做市
audacitymaker	大胆的做市策略	做市
convert	转换策略是一个工具，可帮助你将特定资产转换为目标资产	工具	无
dca	成本平均策略	工具
dca2	第二代成本平均策略	工具
rebalance	根据目标权重重新平衡你的投资组合	再平衡	无
deposit2transfer	自动将存款转入另一个账户	工具	无
sentinel	监控交易所的连接性和健康状况	工具	无
tri	三角套利策略	套利	无
random	为测试目的随机下单	工具	无

支持的交易所

• 币安现货交易所（包括 binance.us）
• OKX 现货交易所（前 OKEX）
• Kucoin 现货交易所
• MAX 现货交易所（位于中国台湾）
• Bitget 交易所
• Bybit 交易所
• Coinbase 交易所
• Bitfinex 交易所

文档与通用主题

• 请查看 文档索引

要求

• Go SDK 1.25

• Linux / MacOS / Windows (WSL)

• 注册账户后获取您的交易所 API 密钥和密钥：您可以选择一个或多个交易所：

  • MAX: https://max.maicoin.com/signup?r=c7982718
  • 币安: https://accounts.binance.com/en/register?ref=38192708
  • OKEx: https://www.okex.com/join/2412712?src=from:ios-share
  • Kucoin: https://www.kucoin.com/ucenter/signup?rcode=r3KX2D4
  • Bybit: https://www.bybit.com/
  • Bitget: https://www.bitget.com/
  • Coinbase: https://www.coinbase.com/
  • Bitfinex: https://www.bitfinex.com/

  本项目由一小群人维护和支持。如果您想支持该项目，请使用提供的链接和上述推荐码在各交易所注册。

安装

从二进制文件安装

以下脚本将帮助您设置配置文件和 dotenv 文件：

# 币安交易所的网格交易策略
bash <(curl -s https://raw.githubusercontent.com/c9s/bbgo/main/scripts/setup-grid.sh) binance

# MAX 交易所的网格交易策略
bash <(curl -s https://raw.githubusercontent.com/c9s/bbgo/main/scripts/setup-grid.sh) max

# 币安交易所的布林格网格交易策略
bash <(curl -s https://raw.githubusercontent.com/c9s/bbgo/main/scripts/setup-bollgrid.sh) binance

# MAX 交易所的布林格网格交易策略
bash <(curl -s https://raw.githubusercontent.com/c9s/bbgo/main/scripts/setup-bollgrid.sh) max

如果您已经拥有配置，也可以使用仅下载的脚本：

bash <(curl -s https://raw.githubusercontent.com/c9s/bbgo/main/scripts/download.sh)

或者访问 发布页面，手动下载。

自 v2 版本起，我们引入了 dnum 的新浮点实现，以支持更高精度的小数。有关下载和设置，请参阅 Dnum 安装指南。

一键 Linode StackScript

StackScript 允许您一键部署带有 bbgo 的轻量级实例。

• BBGO 网格交易（币安）https://cloud.linode.com/stackscripts/950715
• BBGO 网格交易 USDT/TWD（MAX）https://cloud.linode.com/stackscripts/793380
• BBGO 网格交易 USDC/TWD（MAX）https://cloud.linode.com/stackscripts/797776
• BBGO 网格交易 LINK/TWD（MAX）https://cloud.linode.com/stackscripts/797774
• BBGO 网格交易 USDC/USDT（MAX）https://cloud.linode.com/stackscripts/797777
• BBGO 网格交易（MAX）https://cloud.linode.com/stackscripts/795788
• BBGO 布林格指标（币安）https://cloud.linode.com/stackscripts/1002384

从源代码构建

请参阅 从源代码构建

配置

添加您的 dotenv 文件：

# 对于币安交易所，如果您有 API 密钥和密钥
BINANCE_API_KEY=
BINANCE_API_SECRET=

# 如果您想使用 binance.us，请将此值更改为 1
BINANCE_US=0

# 对于 MAX 交易所，如果您有 API 密钥和密钥
MAX_API_KEY=
MAX_API_SECRET=

# 对于 OKEx 交易所，如果您有 API 密钥和密钥
OKEX_API_KEY=
OKEX_API_SECRET=
OKEX_API_PASSPHRASE

# 对于 Kucoin 交易所，如果您有 API 密钥和密钥
KUCOIN_API_KEY=
KUCOIN_API_SECRET=
KUCOIN_API_PASSPHRASE=
KUCOIN_API_KEY_VERSION=2

# 对于 Bybit 交易所，如果您有 API 密钥和密钥
BYBIT_API_KEY=
BYBIT_API_SECRET=

# 对于 Bitget 交易所，如果您有 API 密钥和密钥
BITGET_API_KEY=
BITGET_API_SECRET=
BITGET_API_PASSPHRASE=

# 对于 Coinbase 交易所，如果您有 API 密钥和密钥
COINBASE_API_KEY=
COINBASE_API_SECRET=

# 对于 Bitfinex 交易所，如果您有 API 密钥和密钥
BITFINEX_API_KEY=
BITFINEX_API_SECRET=

准备您的 dotenv 文件 .env.local 和 BBGO yaml 配置文件 bbgo.yaml。

如需查看可用的环境变量，请参阅 环境变量。

最小化的 bbgo.yaml 可以通过以下命令生成：

curl -o bbgo.yaml https://raw.githubusercontent.com/c9s/bbgo/main/config/minimal.yaml

运行策略：

bbgo run

启动带前端仪表盘的 bbgo：

bbgo run --enable-webserver

如果您想切换到另一个 dotenv 文件，可以添加 --dotenv 或 --config 选项：

bbgo sync --dotenv .env.dev --config config/grid.yaml --session binance

查询转账记录：

bbgo transfer-history --session max --asset USDT --since "2019-01-01"

高级配置

将系统时间与币安同步

BBGO 提供了一个适用于 UNIX 系统/子系统的脚本，用于将日期与币安同步。在此之前需要安装 jq 和 bc。在 Ubuntu 上安装依赖项的命令如下：

sudo apt install -y bc jq

然后执行同步脚本：

sudo ./scripts/sync_time.sh

您还可以将该脚本添加到 crontab 中，以便定期将系统时间与币安同步。

测试网（模拟交易）

目前仅支持币安测试网。要在测试网上运行 bbgo，请从 Binance 测试网络 申请新的 API 密钥，并在启动 bbgo 之前设置以下环境变量：

export PAPER_TRADE=1
export DISABLE_MARKET_CACHE=1 # 测试网支持的交易对远少于主网

通知

• 设置 Telegram 通知
• 设置 Slack 通知

同步交易数据

默认情况下，BBGO 不会从交易所会话中同步您的交易数据，因此难以准确计算您的盈亏。

通过将交易和订单同步到本地数据库，您可以获得一些好处，例如盈亏计算、回测和资产计算。

您只能使用 MySQL 或 SQLite 数据库驱动来存储您的交易数据。

注意：SQLite 并未完全支持，我们建议您使用 MySQL 而不是 SQLite。

配置 MySQL 数据库

要使用 MySQL 数据库进行数据同步，首先需要安装 MySQL 服务器：

# 对于 Ubuntu Linux
sudo apt-get install -y mysql-server

# 对于较新的 Ubuntu Linux
sudo apt install -y mysql-server

或者在 Docker 中运行 MySQL。

创建您的 MySQL 数据库：

mysql -uroot -e "CREATE DATABASE bbgo CHARSET utf8"

然后在您的 .env.local 文件中添加以下环境变量：

DB_DRIVER=mysql
DB_DSN="user:password@tcp(127.0.0.1:3306)/bbgo"

配置 SQLite3 数据库

要使用 SQLite3 而不是 MySQL，只需在您的 .env.local 文件中添加以下环境变量：

DB_DRIVER=sqlite3
DB_DSN=bbgo.sqlite3

同步您自己的交易数据

在配置好数据库后，您可以从交易所同步自己的交易数据。

请参阅 为私有交易数据配置同步

使用 Redis 在 BBGO 会话之间保持持久化

要使用 Redis，首先需要安装 Redis 服务器：

# 对于 Ubuntu/Debian Linux
sudo apt-get install -y redis

# 对于较新的 Ubuntu/Debian Linux
sudo apt install -y redis

在您的 bbgo.yaml 中设置以下环境变量：

persistence:
  redis:
    host: 127.0.0.1  # 您的 Redis 服务器的 IP 地址或主机名，如果与 BBGO 相同则为 127.0.0.1
    port: 6379  # 到 Redis 服务器的端口，默认为 6379
    db: 0  # 要使用的数据库编号。如果您希望避免与其他应用程序使用 Redis 时发生冲突，可以设置为其他数据库。

内置策略

请查看策略目录 strategy，了解所有内置策略：

• pricealert 策略演示了如何使用通知系统 pricealert。详情请参阅 文档。
• buyandhold 策略演示了如何订阅 K 线事件并提交市价单 buyandhold
• bollgrid 策略实现了基于内置布林带指标的基本网格策略 bollgrid
• grid 策略实现了固定价格区间网格策略 grid。详情请参阅 文档。
• supertrend 策略使用超趋势指标作为趋势判断，并用 DEMA 指标作为噪声过滤器 supertrend。详情请参阅 文档。
• support 策略将高成交量的 K 线视为支撑位 support。详情请参阅 文档。
• flashcrash 策略实现了一种捕捉闪崩行情的策略 flashcrash
• marketcap 策略实现了一种基于市值重新平衡投资组合的策略 marketcap。详情请参阅 文档。
• pivotshort - 专注于做空的策略。
• irr - 收益率策略。
• drift - 偏移策略。
• grid2 - 第二代网格策略。
• rebalance - 根据目标权重重新平衡您的投资组合。rebalance。详情请参阅 文档。

要运行这些内置策略，只需修改配置文件以使其适合您的需求。例如，如果您想运行 buyandhold 策略：

vim config/buyandhold.yaml

# 使用该配置运行 bbgo
bbgo run --config config/buyandhold.yaml

回测

请参阅 回测

添加策略

请参阅 开发策略

编写您自己的私有策略

创建您的 Go 包，使用 go mod 初始化仓库，并将 bbgo 添加为依赖项：

go mod init
go get github.com/c9s/bbgo@main

在策略文件中编写您自己的策略：

vim strategy.go

您可以从 https://github.com/c9s/bbgo/blob/main/pkg/strategy/example/skeleton/strategy.go 获取策略框架。

现在添加您的配置：

mkdir config
(cd config && curl -o bbgo.yaml https://raw.githubusercontent.com/c9s/bbgo/main/config/minimal.yaml)

将您的策略包路径添加到配置文件 config/bbgo.yaml 中：

---
build:
  dir: build
  imports:
  - github.com/your_id/your_swing
  targets:
  - name: swing-amd64-linux
    os: linux
    arch: amd64
  - name: swing-amd64-darwin
    os: darwin
    arch: amd64

运行 bbgo run 命令，bbgo 将编译一个导入您策略的包装二进制文件：

dotenv -f .env.local -- bbgo run --config config/bbgo.yaml

或者您也可以通过以下方式构建自己的包装二进制文件：

bbgo build --config config/bbgo.yaml

相关资源：

• https://github.com/narumiruna/bbgo-template
• https://github.com/narumiruna/bbgo-marketcap
• https://github.com/austin362667/shadow
• https://github.com/jnlin/bbgo-strategy-infinite-grid
• https://github.com/yubing744/trading-gpt

命令用法

向特定交易所会话提交订单

bbgo submit-order --session=okex --symbol=OKBUSDT --side=buy --price=10.0 --quantity=1

列出特定交易所会话的未成交订单

bbgo list-orders open --session=okex --symbol=OKBUSDT
bbgo list-orders open --session=max --symbol=MAXUSDT
bbgo list-orders open --session=binance --symbol=BNBUSDT

取消未成交订单

# 对于 okex，订单 ID 和交易对都必须提供
bbgo cancel-order --session=okex --order-id=318223238325248000 --symbol=OKBUSDT

# 对于 max，只需提供订单 ID 即可
bbgo cancel-order --session=max --order-id=1234566

调试用户数据流

bbgo userdatastream --session okex
bbgo userdatastream --session max
bbgo userdatastream --session binance

动态注入

为了尽量减少策略代码量，bbgo 支持动态依赖注入。

在执行您的策略之前，如果 bbgo 发现您的策略对象中嵌入了正在使用 bbgo 组件的字段，它会将这些组件注入到您的策略对象中。例如：

type Strategy struct {
  Symbol string `json:"symbol"`
  Market types.Market
}

目前仅支持单个交易所策略的组件：

• *bbgo.ExchangeSession
• bbgo.OrderExecutor

如果您在策略中定义了 Symbol string 字段，您的策略将被识别为基于交易对的策略，此时可以自动注入以下类型：

• types.Market

策略执行阶段

1. 从配置文件中加载配置。
2. 分配并初始化交易所会话。
3. 将交易所会话添加到环境（数据层）中。
4. 使用给定的环境初始化交易者对象（逻辑层）。
5. 交易者初始化环境并启动交易所连接。
6. 依次调用策略的 Run() 方法。

交易所 API 示例

请查看示例目录：examples

初始化 MAX API：

key := os.Getenv("MAX_API_KEY")
secret := os.Getenv("MAX_API_SECRET")

maxRest := maxapi.NewRestClient(maxapi.ProductionAPIURL)
maxRest.Auth(key, secret)

创建用户数据流以获取订单簿（深度）：

stream := max.NewStream(key, secret)
stream.Subscribe(types.BookChannel, symbol, types.SubscribeOptions{})

streambook := types.NewStreamBook(symbol)
streambook.BindStream(stream)

部署

• Helm Chart
• 裸机或 VPS

开发

• 添加新交易所
• 迁移

设置本地仓库

1. 在 GitHub 仓库中点击“Fork”按钮。
2. 将您的 fork 仓库克隆到 $GOPATH/github.com/c9s/bbgo。
3. 切换到 $GOPATH/github.com/c9s/bbgo 目录。
4. 创建一个分支并开始开发。
5. 测试您的更改。
6. 将更改推送到您的 fork。
7. 发送拉取请求。

测试桌面应用

对于 WebView：

make embed && go run -tags web ./cmd/bbgo-webview

对于 Lorca：

make embed && go run -tags web ./cmd/bbgo-lorca

常见问题解答

什么是仓位？

• 基础货币与报价货币 https://www.ig.com/au/glossary-trading-terms/base-currency-definition
• 如何计算平均成本？ https://www.janushenderson.com/en-us/investor/planning/calculate-average-cost/

寻找新的交易策略吗？

您可以撰写一篇关于 BBGO 的文章，主题不限，字数在 750–1500 字之间，作为交换，我可以为您实现该策略（具体取决于复杂度和工作量）。如果您感兴趣，请通过 Telegram https://t.me/c123456789s 或 X/Twitter https://x.com/c9s 私信我，我们可以进一步讨论。

添加对新加密交易所的支持？

如果您希望 BBGO 支持当前未包含的某个加密交易所，我们可以为您实现这一功能。费用为 10 ETH。如果您有兴趣，请通过 Telegram https://t.me/c123456789s 私信我。

社区

• Telegram 群组 https://t.me/bbgo_intl
• Telegram 群组（台湾）https://t.me/bbgocrypto
• X/Twitter https://x.com/bbgotrading

贡献

请参阅 贡献指南

财务支持者

[成为支持者]

BBGO 代币经济模型

为了支持 BBGO 的开发，我们设立了一个赏金池，用于通过发放 $BBG 代币来支持贡献者。详情请查看 $BBG 合约页面 和我们的官方网站。

支持者

• GitBook

许可证

AGPL 许可证

BBGO 快速上手指南

BBGO 是一个用 Go 语言编写的现代化加密货币交易机器人框架，支持多交易所连接、内置多种策略、回测引擎及实时数据流处理。

环境准备

系统要求

• 操作系统: Linux, macOS, Windows (推荐 Linux 服务器部署)
• Go 版本: Go 1.20 或更高版本
• 容器环境 (可选): Docker 20.10+, Kubernetes 1.20+ (如需容器化部署)

前置依赖

• 已安装的 Go 开发环境
• Git 版本控制工具
• 交易所 API Key (用于实盘或模拟盘交易)
• (可选) Slack 或 Telegram Token (用于通知)

安装步骤

方式一：源码安装 (推荐开发者使用)

# 克隆仓库
git clone https://github.com/c9s/bbgo.git
cd bbgo

# 编译主程序 (开启高精度浮点数支持)
go build -tags dnum -o bbgo ./cmd/bbgo

# 验证安装
./bbgo version

方式二：Docker 安装 (推荐生产环境使用)

# 拉取官方镜像
docker pull yoanlin/bbgo:latest

# 创建配置目录
mkdir -p ~/.bbgo

基本使用

1. 初始化配置文件

BBGO 通过 YAML 文件配置策略和交易所。复制示例配置并编辑：

cp config/skeleton.yaml bbgo.yaml

编辑 bbgo.yaml，填入你的交易所密钥和策略参数（以下以网格策略为例）：

sessions:
  max:
    envVarPrefix: max
    # 在此处配置 MAX 交易所的 API Key 和 Secret
    # export MAX_API_KEY=your_key
    # export MAX_API_SECRET=your_secret

exchangeStrategies:
  - on: max
    grid2:
      symbol: BTCUSDT
      upperPrice: 50000
      lowerPrice: 30000
      gridNum: 20
      amount: "100" # 每格投入金额
      profitSpread: 0.005 # 利润间距

2. 运行交易机器人

本地运行：

# 确保已设置环境变量或使用配置文件
export MAX_API_KEY=your_key
export MAX_API_SECRET=your_secret

./bbgo run --config bbgo.yaml

Docker 运行：

docker run -it --rm \
  -v $(pwd)/bbgo.yaml:/root/bbgo.yaml \
  -e MAX_API_KEY=your_key \
  -e MAX_API_SECRET=your_secret \
  yoanlin/bbgo:latest run --config /root/bbgo.yaml

3. 访问 Web 仪表盘

启动成功后，默认在浏览器访问 http://localhost:8080 即可查看实时订单、资产状况及策略日志。

4. 执行回测 (可选)

使用内置的回测引擎验证策略表现：

./bbgo backtest --config bbgo.yaml --base-asset-baseline --start 2023-01-01 --end 2023-12-31

回测报告将在终端输出，并可在 Web 仪表盘中查看可视化图表。