Need help with bbgo?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

359 Stars 83 Forks MIT License 2.2K Commits 62 Opened issues


The modern cryptocurrency trading bot written in Go.

Services available


Need anything else?

Contributors list


A trading bot framework written in Go. The name bbgo comes from the BB8 bot in the Star Wars movie. aka Buy BitCoin Go!

Current Status

Build Status


  • Exchange abstraction interface
  • Stream integration (user data websocket)
  • PnL calculation
  • Slack notification
  • KLine-based backtest
  • Built-in strategies
  • Multi-session support
  • Standard indicators (SMA, EMA, BOLL)

Supported Exchanges

  • MAX Spot Exchange (located in Taiwan)
  • Binance Spot Exchange
  • FTX Spot Exchange


Get your exchange API key and secret after you register the accounts (you can choose one or more exchanges):

Since the exchange implementation and support are done by a small team, if you like the work they've done for you, It would be great if you can use their referral code as your support to them. :-D


Install from binary

The following script will help you set up a config file, dotenv file:


Install and Run from the One-click Linode StackScript:

Install from source

If you need to use go-sqlite, you will need to enable CGO first:

CGO_ENABLED=1 go get

Install the bbgo command:

go get -u

Add your dotenv file:

# if you have one

if you have one


if you have one


specify it if credentials are for subaccount


Prepare your dotenv file

and BBGO yaml config file

The minimal bbgo.yaml could be generated by:

curl -o bbgo.yaml

To sync your own trade data:

bbgo sync --session max
bbgo sync --session binance

If you want to switch to other dotenv file, you can add an

option or
bbgo sync --dotenv --config config/grid.yaml --session binance

To sync remote exchange klines data for backtesting:

bbgo backtest --exchange binance -v --sync --sync-only --sync-from 2020-01-01

To run backtest:

bbgo backtest --exchange binance --base-asset-baseline

To query transfer history:

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

To calculate pnl:

bbgo pnl --exchange binance --asset BTC --since "2019-01-01"

To run strategy:

bbgo run

Advanced Setup

Setting up Telegram Bot Notification

Open your Telegram app, and chat with @botFather


to create a new bot

Enter the bot display name. ex.


Enter the bot username. This should be global unique. e.g.,


Botfather will response your a bot token. Keep bot token safe


in the
file, e.g.,

For the telegram chat authentication (your bot needs to verify it's you), if you only need a fixed authentication token, you can set

in the
file, e.g.,

Run your bbgo,

Open your Telegram app, search your bot



/auth {code}

Done! your notifications will be routed to the telegram chat.

Setting up Slack Notification

Put your slack bot token in the .env.local file:


Synchronizing Trading Data

By default, BBGO does not sync your trading data from the exchange sessions, so it's hard to calculate your profit and loss correctly.

By synchronizing trades and orders to the local database, you can earn some benefits like PnL calculations, backtesting and asset calculation.

Configure MySQL Database

To use MySQL database for data syncing, first you need to install your mysql server:

# For Ubuntu Linux
sudo apt-get install -y mysql-server

Or run it in docker

Create your mysql database:

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

Then put these environment variables in your

[email protected](

Configure Sqlite3 Database

Just put these environment variables in your


Built-in Strategies

Check out the strategy directory strategy for all built-in strategies:

  • pricealert
    strategy demonstrates how to use the notification system pricealert
  • xpuremaker
    strategy demonstrates how to maintain the orderbook and submit maker orders xpuremaker
  • buyandhold
    strategy demonstrates how to subscribe kline events and submit market order buyandhold
  • bollgrid
    strategy implements a basic grid strategy with the built-in bollinger indicator bollgrid
  • grid
    strategy implements the fixed price band grid strategy grid
  • flashcrash
    strategy implements a strategy that catches the flashcrash flashcrash

To run these built-in strategies, just modify the config file to make the configuration suitable for you, for example if you want to run

vim config/buyandhold.yaml

run bbgo with the config

bbgo run --config config/buyandhold.yaml

Adding New Built-in Strategy

Fork and clone this repository, Create a directory under

, write your strategy at

Define a strategy struct:

package newstrategy

import ( "" )

type Strategy struct { Symbol string json:"symbol" Param1 int json:"param1" Param2 int json:"param2" Param3 fixedpoint.Value json:"param3" }

Register your strategy:

package newstrategy

const ID = "newstrategy"

const stateKey = "state-v1"

var log = logrus.WithField("strategy", ID)

func init() { bbgo.RegisterStrategy(ID, &Strategy{}) }

Implement the strategy methods:

package newstrategy

func (s *Strategy) Subscribe(session *bbgo.ExchangeSession) { session.Subscribe(types.KLineChannel, s.Symbol, types.SubscribeOptions{Interval: "2m"}) }

func (s *Strategy) Run(ctx context.Context, orderExecutor bbgo.OrderExecutor, session *bbgo.ExchangeSession) error { // .... return nil }


, and import the package, like this:
package cmd

// import built-in strategies import ( _ "" _ "" _ "" _ "" _ "" _ "" _ "" _ "" _ "" _ "" )

Write your own strategy

Create your go package, and initialize the repository with

go mod
and add bbgo as a dependency:
go mod init
go get[email protected]

Write your own strategy in the strategy file:

vim strategy.go

You can grab the skeleton strategy from

Now add your config:

mkdir config
(cd config && curl -o bbgo.yaml

Add your strategy package path to the config file

  dir: build
  - name: swing-amd64-linux
    os: linux
    arch: amd64
  - name: swing-amd64-darwin
    os: darwin
    arch: amd64


bbgo run
command, bbgo will compile a wrapper binary that imports your strategy:
dotenv -f .env.local -- bbgo run --config config/bbgo.yaml

Or you can build your own wrapper binary via:

bbgo build --config config/bbgo.yaml

Command Usages

Submitting Orders to a specific exchagne session

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

Listing Open Orders of a specific exchange session

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

Canceling an open order

# both order id and symbol is required for okex
bbgo cancel-order --session=okex --order-id=318223238325248000 --symbol=OKBUSDT

for max, you can just give your order id

bbgo cancel-order --session=max --order-id=1234566

Debugging user data stream

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

Dynamic Injection

In order to minimize the strategy code, bbgo supports dynamic dependency injection.

Before executing your strategy, bbgo injects the components into your strategy object if it found the embedded field that is using bbgo component. for example:

type Strategy struct {

And then, in your code, you can call the methods of Notifiability.

Supported components (single exchange strategy only for now):

  • *bbgo.Notifiability
  • bbgo.OrderExecutor

If you have

Symbol string
field in your strategy, your strategy will be detected as a symbol-based strategy, then the following types could be injected automatically:
  • *bbgo.ExchangeSession
  • types.Market

Strategy Execution Phases

  1. Load config from the config file.
  2. Allocate and initialize exchange sessions.
  3. Add exchange sessions to the environment (the data layer).
  4. Use the given environment to initialize the trader object (the logic layer).
  5. The trader initializes the environment and start the exchange connections.
  6. Call strategy.Run() method sequentially.

Exchange API Examples

Please check out the example directory: examples

Initialize MAX API:

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

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

Creating user data stream to get the orderbook (depth):

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

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

How To Add A New Exchange


Helm Chart

If you need redis:

helm repo add bitnami
helm install redis bitnami/redis

To get the dynamically generated redis password, you can use the following command:

export REDIS_PASSWORD=$(kubectl get secret --namespace bbgo redis -o jsonpath="{.data.redis-password}" | base64 --decode)

Prepare your docker image locally (you can also use the docker image from docker hub):

make docker DOCKER_TAG=1.16.0

The docker tag version number is from the file Chart.yaml

Choose your instance name:

export INSTANCE=grid

Prepare your secret:

kubectl create secret generic bbgo-$INSTANCE --from-env-file .env.local

Configure your config file, the chart defaults to read config/bbgo.yaml to create a configmap:

cp config/grid.yaml bbgo-$INSTANCE.yaml
vim bbgo-$INSTANCE.yaml

Prepare your configmap:

kubectl create configmap bbgo-$INSTANCE --from-file=bbgo.yaml=bbgo-$INSTANCE.yaml

Install chart with the preferred release name, the release name maps to the previous secret we just created, that is,

helm install --set existingConfigmap=bbgo-$INSTANCE bbgo-$INSTANCE ./charts/bbgo

To use the latest version:

helm install --set existingConfigmap=bbgo-$INSTANCE --set image.tag=latest bbgo-$INSTANCE ./charts/bbgo

To upgrade:

helm upgrade bbgo-$INSTANCE ./charts/bbgo
helm upgrade --set image.tag=1.15.2 bbgo-$INSTANCE ./charts/bbgo

Delete chart:

helm delete bbgo-$INSTANCE


The overview function flow at bbgo image info

Setting up your local repository

  1. Click the "Fork" button from the GitHub repository.
  2. Clone your forked repository into
  3. Change directory into
  4. Create a branch and start your development.
  5. Test your changes.
  6. Push your changes to your fork.
  7. Send a pull request.

Adding new migration

rockhopper --config rockhopper_sqlite.yaml create --type sql add_pnl_column
rockhopper --config rockhopper_mysql.yaml create --type sql add_pnl_column


bash utils/ add_pnl_column

Be sure to edit both sqlite3 and mysql migration files.

To test the drivers, you can do:

rockhopper --config rockhopper_sqlite.yaml up
rockhopper --config rockhopper_mysql.yaml up

Then run the following command to compile the migration files into go files:

make migrations

Setup frontend development environment

cd frontend
yarn install

Testing Desktop App

for webview

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

for lorca

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


By contributing pull requests

Any pull request is welcome, documentation, format fixing, testing, features.

By registering account with referral ID

You may register your exchange account with my referral ID to support this project.

By small amount cryptos

  • BTC address
  • USDT ERC20 address


You can join our telegram channels:


BBGO has a token BBG for the ecosystem (contract address:

Each issue has its BBG label, by completing the issue with a pull request, you can get correspond amount of BBG.

If you have feature request, you can offer your BBG for contributors.

BBG/ETH liquidity pool on Uniswap:

For further request, please contact us:


MIT License

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.