Trade Simulator

A TypeScript/Node.js application for simulating stock trading portfolios and analyzing performance metrics.

Features

• Import trades from CSV/JSON files
• Fetch real market data from Nordnet API
• Simulate portfolio performance over time
• Calculate comprehensive performance metrics (returns, Sharpe ratio, drawdown, etc.)
• Generate charts and visualizations
• Export results to JSON/CSV
• PostgreSQL persistence for historical simulations

Quick Start

Prerequisites

• Node.js >= 20.0.0
• pnpm >= 9.0.0
• PostgreSQL database

Installation

pnpm install

Configuration

Copy .env.example to .env and configure:

cp .env.example .env

Edit .env with your database and Nordnet API credentials.

Database Setup

pnpm db:migrate

Build

pnpm build

Run

pnpm trade-sim simulate ./examples/trades.csv

Development

# Run in watch mode
pnpm dev

# Run tests
pnpm test

# Run tests with UI
pnpm test:ui

# Type check
pnpm type-check

# Lint
pnpm lint

# Format
pnpm format

Documentation

See docs/ for detailed documentation.

License

MIT