Debut - Trading Framework
Debut is an ecosystem for developing and launching trading strategies. An analogue of the well-known ZenBot, but with much more flexible possibilities for constructing strategies. All you need to do is come up with and describe the entry points to the market and connect the necessary plugins to work. Everything else is a matter of technology: genetic algorithms - will help you choose the most effective parameters for the strategy (period, stops, and others), ticker selection module - will help you find an asset suitable for the strategy (token or share), on which it will work best.
Debut is based on the architecture of the core and add-on plugins that allow you to flexibly customize any solution. The main goal of the entire Debut ecosystem is to simplify the process of creating and launching working trading robots on various exchanges.
Features
- Multiple exchanges API
- Backtesting with historical data
- Backtesting results visualization
- Backtesting live preview
- Strategy optimisation (genetic algorithms, multi thread)
- Stretegy overfitting control (Walk-Forward)
- Cross timeframe candles access
- Simple working with data using callbacks e.g. onCandle, onTick, onDepth ...
- Written in TypeScript (JavaScript), may be executed in browser
- Customizable with plugins
- Can use community edition for free with limitations
Available brokers
Didn't see your broker? You can donate for support.
Community edition
We believe in the power of the community! That is why we decided to publish the project. The community version is free, but it has some limitations in commercial use (income from trading startups is not commerce), as well as technical differences in testing strategies. Join the community, join the developer chat
Enterprise edition
(Available by subscription for $20/mo)
- Cross timeframe candles access (from lower to higher candles)
- Advanced tick emulation in backtesting (60+ ticks per candle)
- Tinkoff and Alpaca supports all timeframes (programmaticaly solved broker issue)
We are streaming Enterprise-based deals live on our telegram channel
Find out the price by sending a request to [email protected]
Remember! Starting a bot and trading in general requires careful study of the associated risks and parameters. Incorrect settings can cause serious financial losses.
The project has two starting trading strategies "For example" how to work with the system.
CCI Dynamic strategy report for last 100 days
Report analysis
startBalance: 500
balance: 1183.97
maxBalance: 1186.37
minBalance: 500
maxMarginUsage: 1892.54
profit: 683.97
long: 273
longRight: 243
short: 282
shortRight: 277
absoluteDD: 21.06
relativeDD: 30.31
potentialDD: 51.9
maxWin: 6.21
maxLoose: -8.14
profitProb: 0.94
looseProb: 0.06
avgProfit: 4.54
avgLoose: 47.95
expectation: 1.23
failLine: 6
rightLine: 20
avgFailLine: 1.93
avgRightLine: 5.36
ticksHandled: 9637
candlesHandled: 9636
Strategy statistics were collected based on the plugin statistics, follow the link to learn more about the meaning of some statistics.
Visualization is done using the Report plugin.
System requirements
To work, you need NodeJS 16.xx/npm 7.xx (installation instructions)
Documentation
Project file structure
| - .tokens.json - custom access tokens for working with the exchange
| - schema.json - description of the location of the startup files
| - public/- folder for finder reports (created when finder starts)
| - src/
| - strategies/
| - strategy1/- strategies directory
| - bot.ts - Strategy implementation
| - meta.ts - Meta data, for launching and for optimization
| - cfgs.ts - Configurations, for launching in tester and genetic
| - strategy2/
...
Installation and configuration
Obtaining API tokens
Installing tokens
To work, you need to create a .tokens.json file, add a token to it for work.
For Tinkoff (instructions):
{
"tinkoff": "YOUR_TOKEN",
"tinkoffAccountId": "YOUR_ACCOUNT_ID",
}Get your tinkoff accounts by this hack and copy one of available account identity to tinkoffAccountId:
execute command npm run getAccountId
or
tinkoffTransport.api.users.getAccounts({}).then(res => {
console.log(res);
});For Binance (instructions):
{
"binance": "YOUR_TOKEN",
"binanceSecret": "YOUR_SECRET"
}For Alpaca (Alpaca instructions):
{
"alpacaKey": "YOUR_TOKEN",
"alpacaSecret": "YOUR_SECRET"
}All tokens can be getted by call: cli.getTokens() also you can use any field name for the token.
Installing npm packages
To install packages, run:
npm installCreating strategy
Command will create strategy in src/strategies direction with bot.ts, cfgs.ts and meta.ts files inside and add it to schema.json
npm run plop StrategyNameBuild the project
npm run compileIt is recommended to build before each test run
npm run compile && npm run ...
Start testing on historical data
Historical data will be loaded automatically at startup All loaded data is saved in the history folder in the root of the project, then reused.
Before starting, make sure:
- The
cfgs.tsfile contains the ticker you need - To get history in the
.tokens.json filea token may be required - The history of a stock or token exists in the requested number of days
To start, run the command:
npm run testing -- --bot=FTBot --ticker=CRVUSDT --days=200 --gap=20To view the test results in a browser, execute
npm run serveThe results will be available for viewing on http://localhost: 5000/
You can read more about the test run parameters in the documentation
Run genetic optimization
Run the command:
npm run genetic -- --bot=FTBot --ticker=CRVUSDT --days=200 --gap=30 --gen=12 --pop=2000or with gap 60 days from now, and WFO enabled with type rolling also available --wfo default type is 'anchored' wfo
npm run genetic -- --ticker=BTCUSDT --bot=FTBot --amount=500 --gen=25 --pop=10000 --days=300 --gap=60 --wfo=rollingMore details about the launch parameters of the genetics can be found in the documentation
After starting with the --log parameter, the geneticist will output data to the console
Binance history loading from Wed Nov 18 2020 03:00:00 GMT + 0300 (Moscow Standard Time) ...
----- Genetic Start with 17314 candles -----
Generation: 0
Generation time: 5.15 s
Stats: {
population: 100,
maximum: 20.8,
minimum: -1.24,
mean: 2.5174,
stdev: 3.8101996325652054
}
Generation: 1
...Run genetic optimization with tickers/tokens selection
Run the command:
npm run finder -- --bot=FTBot --ticker=CRVUSDT --days=200 --gap=30 --gen=12 --pop=2000 --logUse the --crypt option to take crypto pairs from the./Crypt.json file (By default, there are actual Binance cross-margin pairs)
By default, a set of stock tickers is used for streaming optimization from the file stocks.json
You can read more about the parameters for launching streaming genetics in the documentation
Starting a strategy
Install any process manager for NodeJS, for example PM2,,,
npm install -g pm2Execute the launch command, the path to the strategy launch file in the ./Out directory.
An example of such a file can be found here /src/bootstrap.ts
pm2 start ./out/bootstrap.jsFurther, for operation and monitoring, you can use pm2 command:
pm2 list - a list of active processes
pm2 delete $ pid - stop a process
pm2 log - to view the logs of running processes
and other commands, which can be found in the documentation of the process manager.
Debut is flexible for any tools
Buy / Sell ratio
A measure of the activity rating of buyers and sellers for several pairs. This tool is based on the method of counting all purchases listed on the exchange and all sales, they are calculated for several large tokens dominating the market. Parameter tickers = ['ETH', 'BTC', 'ETC', 'XRP']; A fast and slow moving average (SMA) is used to smooth and track changes in activity. Further, for less voluminous tokens (altcoins), the correlation between the change in their price and the change in the buyer's index is calculated. Deals are formed for a certain coin according to the simple logic that if the buyer's activity is above 50% and the price correlation is high, or the share of buyers is less than 50% and the price correlation is high (falling).
Start
npm run compile && node ./out/tools/buysellratio/index.jsScreenshot
