Skip to content
@backtest-kit

Backtest Kit

Production-grade algorithmic trading infrastructure for Node.js — backtest, paper, and live trading from a single codebase. Telegram, UI, PineScript GUI, Runner

🧿 backtest-kit

Production-grade algorithmic trading infrastructure for Node.js — from Pine Script execution and LLM signal generation to live exchange connectivity and interactive dashboards. One codebase for backtest, paper, and live trading.

screenshot

Ask DeepWikinpmTypeScriptLicense


🚀 Quick Start

Start here: Clone the reference implementation — a fully working news-sentiment AI trading system with LLM forecasting, multi-timeframe data, and a documented February 2026 backtest.

# Scaffold a new AI agent trading project
npx -y @backtest-kit/cli --init --output my-trading-bot
cd my-trading-bot
npm start

🧩 Ecosystem

PackageDescription
backtest-kitCore engine — temporal context via AsyncLocalStorage, exchange adapters, risk management, signal lifecycle
@backtest-kit/uiFull-stack dashboard — candlestick charts, signal tracking, PnL analytics, trailing stops visualization
@backtest-kit/signals50+ technical indicators across 4 timeframes, order book depth, AI-ready markdown reports
@backtest-kit/ollamaMulti-provider LLM wrapper (OpenAI, Claude, DeepSeek, Grok, Mistral, Ollama, 10+) with structured output
@backtest-kit/pinetsRun TradingView Pine Script v5/v6 locally — 1:1 syntax, 60+ built-in indicators
@backtest-kit/graphTyped DAG execution for multi-timeframe strategies — parallel source nodes, serializable to DB
@backtest-kit/cliCLI for scaffolding AI agent trading projects with CLAUDE.md skill contracts

✨ Core Design Principles

Look-Ahead Bias is Architecturally Impossible

Temporal context flows automatically through AsyncLocalStorage — every getCandles() call is implicitly bounded to the current backtest tick. No timestamp parameters to pass, no future data to accidentally leak.

Same Code, Backtest → Paper → Live

Strategy functions are unaware of execution mode. Switch from historical simulation to real exchange connectivity by changing one flag.

LLM as Signal Generator

The framework provides structured pipelines for injecting multi-timeframe technical analysis, order book data, and news sentiment into LLM context — while keeping temporal isolation and validation invariants intact.

Pine Script indicators if you want to

Port your existing TradingView strategies to Node.js without rewriting a single line — @backtest-kit/pinets executes Pine Script v5/v6 locally via the PineTS runtime, extracts plot values into typed objects, and feeds them directly into the signal pipeline alongside LLM-generated signals.


📚 Articles

A series of in-depth articles documenting the engineering decisions behind the framework:

  1. Look-Ahead Bias — How AsyncLocalStorage makes temporal contamination architecturally impossible
  2. Second-Order Chaos — Why thousands of identical bots trade against themselves at a loss
  3. Claude Trader — How AI gets hands for autonomous strategy iteration via Claude Code
  4. Option Hedging — Why the price drops in a single candle and how to adapt
  5. AI Strategy Workflow — AI workflow for identifying and updating liquidation cascade criteria
  6. AI Strategy Blueprint — ReAct-pattern LLM trading agent with live test results
  7. AI News Trading Signals — News sentiment analysis as a trading signal: methodology and backtest
  8. AI Liquidity Harvesting — How to detect and invert manipulative Telegram signal channels
  9. Pine Script Local Markets — Running Pine Script on exchanges not available in TradingView
  10. DCA Averaging Strategy — Asset price averaging mechanics, drawdown reality, and broker deception

🔗 Links


MIT © tripolskypetr

Pinned Loading

  1. ai-trading-mcpai-trading-mcpPublic

    MCP-driven crypto trading rig: Claude (or any MCP client) trades a live portfolio through three guarded tools: get_status, open_position, close_position. Capable to read news and charts. Paper and …

    TypeScript 1 1

  2. backtest-kit-redis-mongo-dockerbacktest-kit-redis-mongo-dockerPublic

    A production-grade integration of backtest-kit that replaces the default file-based persistence with MongoDB as the source of truth and Redis as an O(1) lookup cache, packaged with docker-compose f…

    TypeScript 1 3

  3. QFChartQFChartPublic

    QuantForgeOrg chart source code dumped before PineTS has been acquired by LuxAlgo

    TypeScript 8 3

  4. backtest-monorepo-parallelbacktest-monorepo-parallelPublic

    ⚡ 6300× real-time crypto backtesting: 9 symbols in parallel, one Node process. TypeScript monorepo for backtest-kit with a zero-import DI runtime, Mongo + Redis lookup

    TypeScript 1 3

  5. quantforge-indicatorsquantforge-indicatorsPublic

    QuantForgeOrg technical indicators dumped before PineTS has been acquired by LuxAlgo

    TypeScript 4 2

  6. backtest-ollama-crontabbacktest-ollama-crontabPublic

    A TypeScript monorepo demonstrating how to code Ollama outline-based risk filter, with a 15-minute crontab doing live and backtest both Telegram-channel ingestion. Parses signals from a public Tele…

    TypeScript 3

Repositories

Showing 10 of 16 repositories

Top languages

Loading…

Most used topics

Loading…