/Core

Constructor of trading strategies. Based on a flexible core and plugin system. It allows you to configure strategies from ready-made components, only by setting the points of entry into the market. Debut also allows backtesting and genetic optimizations.

Primary LanguageTypeScriptGNU General Public License v3.0GPL-3.0

npm npm License: GPL v3 Support me on Patreon Telegram crypto trading orders stream Telegram stocks trading orders stream

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

Alpaca API Binance API Tinkoff API (Russia only) Request implementation

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 sales@debutjs.io

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)

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 install

Creating 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 StrategyName

Build the project

npm run compile

It 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.ts file 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=20

To view the test results in a browser, execute

npm run serve

The 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=2000

or 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=rolling

More 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 --log

Use 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 pm2

Execute 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.js

Further, 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.js

Screenshot

preview