Turtle Trade Tracker v3.0

README

🐢 Turtle Trading Game

An educational trading simulator for learning the Turtle Strategy (LEAPS + weekly covered calls).

🎮 Try It Live

Minimal Game: [Deploy to get URL]

🚀 Quick Start

Play the Compact Game (NEW!)

A streamlined dashboard view with everything on one screen:

open compact-game/index.html

Play the Minimal Game Locally

Open turtle-game/minimal-game.html in your browser. No build required!

open turtle-game/minimal-game.html

Run the Full TypeScript Game (In Development)

cd turtle-game
npm install
npm run dev

✨ What's Working

Compact Game (compact-game/index.html) ⭐ NEW
- Single-screen dashboard layout
- Live options chain (click to select strikes)
- Large candlestick chart
- Real-time position cards
- Dark professional theme
Minimal Game (turtle-game/minimal-game.html)
- Complete standalone HTML game
- Validated pricing engine (7.8% error vs real market data)
- Multi-week rolling with LEAPS + weekly calls
- Historical context candles
- Black & white candlestick charts
- Full P&L breakdown
Pricing Models
- Python reference implementation (simplified_trading_simulator.py)
- TypeScript implementation (turtle-game/src/lib/pricing/simplifiedPricing.ts)
- Both match exactly

📚 Documentation

CONTEXT.md - Current session summary and progress
turtle-spec.md - Full game specification (4 phases)
START_FRESH.md - Previous session context

🎯 Roadmap

See the task list for detailed development plan:

Phase 1: Foundation (Current)

Validated pricing engine
Minimal working game
Historical context candles

Phase 2: Tutorial Mode (Next)

Tutorial 1: Shares vs LEAPS
Tutorial 2: Introducing Weekly Calls
Tutorial 3: Time and Moneyness
Tutorial 4: Capital Deployment

Phase 3-6: Coming Soon

Demonstration Scenarios
Challenge Modes
Free Play Mode
Polish & Features

🧪 Testing

Python Tests

python3 simplified_trading_simulator.py
python3 test_short_call_expiry.py
python3 test_weekly_call_pricing.py

TypeScript Tests

cd turtle-game
npx tsx src/lib/pricing/testSimplifiedPricing.ts
npx tsx src/lib/pricing/testShortCallExpiry.ts

🛠 Tech Stack

Frontend: TypeScript + Vite
Styling: Tailwind CSS
Charts: Canvas API (minimal game), lightweight-charts (full game)
State: Plain TypeScript objects (for now)

📊 Pricing Model

Simplified educational model (not Black-Scholes):

Base extrinsic: $450 (7 DTE ATM)
Refined moneyness curve for $1 strike increments
Simple delta/theta calculations
7.8% average error vs real SPY options data

🤝 Contributing

This is an educational project. Feedback welcome!