Быстрый старт TradeJS на TypeScript

Создайте локальный TradeJS-проект из публичных npm-пакетов:

npx create-tradejs

Команда создаёт папку tradejs-project, устанавливает совместимые версии пакетов, запускает локальные сервисы Docker и открывает веб-приложение. На странице установки задайте пароль локального пользователя root. После входа откроется главная страница с графиком Coinbase BTCUSDT.

Кнопка Create backtest в правом верхнем углу открывает форму запуска. Пошаговый сценарий приведён в разделе Первый бэктест.

После проверки стратегии перейдите к разделу Запуск стратегии в рабочем окружении. Для реальной торговли используется отдельная развёрнутая сборка с точной Git-конфигурацией; бэктест сам по себе стратегию не включает.

Содержимое проекта

• tradejs.config.ts со стандартным набором basePreset;
• .env с локальными адресами авторизации и сгенерированным секретом;
• docker-compose.dev.yml для Redis и PostgreSQL/Timescale;
• команды npm для приложения, бэктестов и инфраструктуры;
• .tradejs/app — сгенерированная копия веб-приложения.

Настраивайте TradeJS из корня проекта. Не редактируйте .tradejs/app: этот каталог создаётся заново при запуске приложения.

Созданный basePreset регистрирует встроенный каталог стратегий, но сам по себе не запускает их. Работающую стратегию нужно явно выбрать в именованной записи runtime.deployments; форма конфигурации и порядок запуска описаны в Запуске стратегии в рабочем окружении.

Повседневный запуск

Выполняйте команды из tradejs-project:

npm run infra-up
npm run doctor
npm run dev

Основные страницы:

• /routes/dashboard — графики, сигналы и запуск бэктеста;
• /routes/backtest — задания бэктеста, прогресс и результаты;
• /routes/strategies — рабочие настройки стратегий, их состояние и пауза.

Остановка локальных сервисов:

npm run infra-down

Ручная установка пакетов

Используйте её только при добавлении TradeJS в существующий проект. Основные пакеты движка должны иметь совместимую старшую версию. Точные версии @tradejs/base и отдельных стратегий фиксируются lock-файлом.

npm install @tradejs/app @tradejs/core @tradejs/node @tradejs/types @tradejs/base @tradejs/cli

Затем настройте проект по инструкции Установка.

Частые ошибки

Docker недоступен

Запустите Docker Desktop или Docker Engine и проверьте docker compose version. Затем повторите npx create-tradejs в новой пустой папке.

Папка уже существует

Передайте другое имя:

npx create-tradejs my-trading-project

Версии пакетов не совпадают

Удалите node_modules, восстановите сохранённый lock-файл и повторите установку. При обновлении меняйте основные пакеты движка вместе, но не принуждайте каждый @tradejs/strategy-* к той же исправляющей версии.