π Get real-time stocks from TradingView
TypeScript backtestingbacktesting-trading-strategiesbitcoinchartscryptocryptocurrencyethereumrealtime-stocksstocksstocks-apistocks-pricestradingtradingviewtradingview-apitradingview-indicatortradingview-replaytradingview-scraper
import { TradingViewError } from '../errors.js';
import type { BacktestReport, SignalRecord, TradeRecord } from './run.js';
import type { Snapshot } from './snapshot.js';
import type { SignalFunction } from './types.js';
export interface ChartData {
/** Frozen candles, oldest first; every `*Bar` index in the report points into this array. */
bars: { time: number; open: number; high: number; low: number; close: number; volume: number }[];
/** Indicator series from `signal.indicators`, one value per bar, null when undefined. */
indicators: Record<string, (number | null)[]>;
/** Open time of the first traded bar (end of the warm-up), Unix seconds. */
warmupEndTime: number | null;
/** Open time of the first out-of-sample bar, Unix seconds. */
splitTime: number | null;
signals: SignalRecord[];
/** Trades by exit id, in entry order. */
trades: Record<string, TradeRecord[]>;
}
/**
* Everything a price chart needs, in one JSON object: candles, indicator lines, warm-up and
* split times, signals with their `refBars`, and the trades of each exit. Pass the same signal
* function as the run to get its indicators (for `rsiDivergence`: `rsi` and `ema`).
*/
export function chartData(report: BacktestReport, snapshot: Snapshot, signal?: SignalFunction): ChartData {
if (snapshot.sha256 !== report.snapshot.sha256) throw new TradingViewError('INVALID_ARGUMENT', 'chartData(): the snapshot is not the one this report ran on');
const raw = signal?.indicators?.(snapshot.candles) ?? {};
const indicators = Object.fromEntries(Object.entries(raw).map(([name, values]) => [
name, Array.from({ length: snapshot.candles.length }, (_, i) => (Number.isFinite(values[i]) ? values[i] : null)),
]));
const trades: Record<string, TradeRecord[]> = Object.fromEntries(report.settings.exits.map((e) => [e.id, []]));
for (const trade of report.trades) (trades[trade.exit] ??= []).push(trade);
for (const list of Object.values(trades)) list.sort((a, b) => a.entryBar - b.entryBar);
return {
bars: snapshot.candles.map(({ time, open, high, low, close, volume }) => ({ time, open, high, low, close, volume })),
indicators,
warmupEndTime: report.segments.inSample.startTime,
splitTime: report.segments.outOfSample.startTime,
signals: report.signals,
trades,
};
}