Before you start back-testing, you need to setup MySQL or SQLite3 . Using MySQL is highly recommended.
First, you need to add the back-testing config to your 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:
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
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
-
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.