bbgo_origin/doc/topics/back-testing.md

Back-testing

Currently bbgo supports two ways to run backtests:

1: Through csv data source (supported right now are binance, bybit and OkEx)

2: Alternatively run backtests through MySQL or SQLite3 . Using MySQL is highly recommended.*

Let's start by adding the back-testing section to your config eg: bbgo.yaml:

backtest:
  # your back-test will start at the 2021-01-10, be sure to sync the data before 2021-01-10 
  # because some indicator like EMA needs more data to calculate the current EMA value.
  startTime: "2021-01-10"

  # your back-test will end at the 2021-01-10
  endTime: "2021-01-21"
  
  # the symbol data that you want to sync and back-test
  symbols:
  - BTCUSDT

  sessions:
  - binance
  
  # feeMode is optional
  # valid values are: quote, native, token
  #   quote: always deduct fee from the quote balance
  #   native: the crypto exchange fee deduction, base fee for buy order, quote fee for sell order.
  #   token: count fee as crypto exchange fee token
  # feeMode: quote
  
  accounts:
    # the initial account balance you want to start with
    binance: # exchange name
      balances:
        BTC: 0.0
        USDT: 10000.0

Note on date formats, the following date formats are supported:

• RFC3339, which looks like 2006-01-02T15:04:05Z07:00
• RFC822, which looks like 02 Jan 06 15:04 MST
• You can also use 2021-11-26T15:04:56

And then, you can sync remote exchange k-lines (candle bars) data for back-testing through csv data source:

bbgo backtest -v --csv --verify --config config/grid.yaml

or use the sql data source like so:

bbgo backtest -v --sync --config config/grid.yaml

To customize the sync data range, add --sync-from:

bbgo backtest -v --sync --sync-only --sync-from 2020-11-01 --config config/grid.yaml

Note that, you should sync from an earlier date before your startTime because some indicator like EMA needs more data to calculate the current EMA value. Here we sync one month before 2021-01-10.

• --sync - sync the data to the latest data point before we start the back-test.
• --sync-only - only the back-test data syncing will be executed. do not run back-test.
• --sync-from - sync the data from a specific endpoint. note that, once you've start the sync, you can not simply add more data before the initial date.
• -v - verbose message output
• --config config/grid.yaml - use a specific config file instead of the default config file ./bbgo.yaml

Run back-test:

bbgo backtest --base-asset-baseline --config config/grid.yaml

or through csv data source

bbgo backtest -v --csv --base-asset-baseline --config config/grid.yaml --output data/backtest

If you're developing a strategy, you might want to start with a command like this:

godotenv -f .env.local -- go run ./cmd/bbgo backtest --config config/grid.yaml --base-asset-baseline

See Also

• apps/backtest-report - BBGO's built-in backtest report viewer

• MDD - If you want to test the max draw down (MDD) you can adjust the start date to somewhere near 2020-03-12.