@vaultcharts/trading-engine

Open-source trading intelligence engine for humans and AI agents.

Pass OHLC bars in → get market structure and a scored setup JSON out.

This is a local npm library. It is not a hosted API, not a broker, and not “another RSI package.”

Commodity indicators (RSI, MACD, SMA) are everywhere. What agents actually need is deterministic structure:

• BOS / swing structure
• Fair value gaps
• Order blocks
• Liquidity sweeps
• Confluence score + entry / stop / targets heuristics

The LLM explains facts — it does not invent whether an FVG exists.

Install

npm install @vaultcharts/trading-engine

Requires Node.js 18+. Runs on your machine / in an agent process. No VaultCharts server.

Quick start

import { analyzeSetup } from '@vaultcharts/trading-engine';

const result = analyzeSetup({
  symbol: 'BTCUSDT',
  timeframe: '4h',
  data: ohlcBars, // { time, open, high, low, close, volume? }[]
});

console.log(result);
// {
//   trend: 'bullish',
//   bos: { direction: 'bullish', level: ... },
//   fvg: { bullish: true, mid: ... },
//   liquiditySweep: { ... },
//   score: 84,
//   entry, stop, targets, riskReward,
//   evidence: ['...']
// }

Hosted API later?

Optional. The same package can power a cloud endpoint later for people who don’t want to run Node. Phase 1–2 do not require a server.

Demo & tests

cd trading-engine
npm install
npm test
npm run demo

Vitest covers FVG detection, risk/reward math, and analyzeSetup / analyzeStructure on synthetic OHLC (deterministic scoring). This is a starter suite — not full coverage of every primitive yet.

License

MIT

Scope

Website (vaultcharts.com) stays: download desktop + free tools + docs pointing at this engine.