Trader

A Fibonacci Trading Analysis Platform implementing the SignalPro strategy for algorithmic trading analysis.

Project Status

Backend: Complete - Fibonacci calculators, signal detection, and harmonic patterns. Frontend: Active development - Chart with Yahoo Finance integration, Fibonacci overlays, pivot detection.

Technology Stack

Component	Technology	Status
Backend	Python 3.13, FastAPI	Complete
Testing	pytest, pytest-cov, ruff, mypy	Active
Frontend	Next.js 16, TypeScript, Tailwind CSS	Active
Charting	TradingView Lightweight Charts	Active
UI Components	shadcn/ui	Active
Market Data	Yahoo Finance (yahoo-finance2)	Active
Database	PostgreSQL	Active

Features

Fibonacci Calculators

• Retracement: Key pullback levels (38.2%, 50%, 61.8%, 78.6%)
• Extension: Levels beyond the range (127.2%, 161.8%, 261.8%)
• Projection: Three-point AB=CD pattern projection
• Expansion: Range expansion levels from a starting move

Signal Bar Detection

Detect trading signals at Fibonacci levels:

• Type 1: Level tested and rejected (stronger signal)
• Type 2: Close beyond level without deep test
• Strength scoring (0.0 - 1.0) based on signal type and price distance

Harmonic Patterns

Detect classic harmonic patterns using XABCD points:

Pattern	AB Ratio	D Level
Gartley	61.8%	78.6% retracement
Butterfly	78.6%	127.2-161.8% extension
Bat	38.2-50%	88.6% retracement
Crab	38.2-61.8%	161.8% extension

API Endpoints

The backend provides 45+ REST endpoints organized by domain:

Core Analysis

Method	Endpoint	Description
GET	/health	Health check
POST	/analyze	Unified analysis - market data, pivots, Fibonacci, signals

Fibonacci Calculations

Method	Endpoint	Description
POST	/fibonacci/retracement	Calculate retracement levels (38.2%, 50%, 61.8%, 78.6%)
POST	/fibonacci/extension	Calculate extension levels (127.2%, 161.8%, 261.8%)
POST	/fibonacci/projection	Calculate 3-point ABC projection levels
POST	/fibonacci/expansion	Calculate expansion levels from pivot

Signal & Pattern Detection

Method	Endpoint	Description
POST	/signal/detect	Detect Type 1/2 signals at Fibonacci level
POST	/harmonic/validate	Validate XABCD harmonic pattern
POST	/harmonic/reversal-zone	Calculate D point for pattern completion
POST	/pivot/detect	Detect swing highs/lows with lookback
POST	/pivot/swings	Classify swings (HH/HL/LH/LL)

Technical Indicators

Method	Endpoint	Description
POST	/indicators/macd	Calculate MACD (configurable periods)
POST	/indicators/rsi	Calculate RSI (default period 14)

Trading Workflow

Method	Endpoint	Description
GET	/workflow/assess	Assess trend from swing patterns
GET	/workflow/align	Check multi-timeframe alignment
GET	/workflow/levels	Identify Fibonacci levels with confluence
GET	/workflow/confirm	Confirm with RSI/MACD indicators
GET	/workflow/categorize	Categorize trade (with_trend/counter/reversal)
GET	/workflow/opportunities	Scan symbols for trade opportunities

Position Sizing

Method	Endpoint	Description
POST	/position/size	Calculate position size from risk
POST	/position/risk-reward	Calculate R:R ratio with targets

Market Data

Method	Endpoint	Description
GET	/market-data	Fetch OHLC with caching and fallback
GET	/market-data/providers	Get provider status and rate limits

Trade Journal

Method	Endpoint	Description
POST	/journal/entry	Create journal entry
GET	/journal/entry/{id}	Get single entry
GET	/journal/entries	List entries (optional symbol filter)
PUT	/journal/entry/{id}	Update entry
DELETE	/journal/entry/{id}	Delete entry
GET	/journal/analytics	Get aggregated analytics
DELETE	/journal/entries	Clear all entries

Project Structure

trader/
├── backend/                # Python/FastAPI backend
│   ├── src/trader/         # Source modules
│   └── tests/              # Unit and integration tests
├── frontend/               # Next.js frontend
│   ├── src/app/            # App router pages and API routes
│   ├── src/components/     # React components (trading, ui)
│   └── src/hooks/          # Custom React hooks
├── pinescript/             # TradingView Pine Script indicators
│   └── indicators/         # Custom indicators matching backend
├── docs/                   # All documentation
│   ├── backend/            # Backend technical docs
│   ├── frontend/           # Frontend technical docs
│   ├── adr/                # Architecture Decision Records
│   └── references/         # Strategy specifications

Quick Start

Option 1: Docker (Recommended)

docker compose up --build

This starts PostgreSQL, backend, and frontend. Access the app at http://localhost:3000

See Development Setup Guide for full documentation.

Option 2: Local Development

# Terminal 1: Database
docker compose -f docker-compose.dev.yml up

# Terminal 2: Backend
cd backend
python -m venv .venv
.venv\Scripts\activate      # Windows
# source .venv/bin/activate # Unix
pip install -e ".[dev]"
alembic upgrade head
uvicorn trader.main:app --reload

# Terminal 3: Frontend
cd frontend
npm install
npm run dev

Visit http://localhost:3000/chart for the interactive chart.

Development Workflow

TDD Process

1. RED: Write failing test first
2. GREEN: Write minimal code to pass
3. REFACTOR: Quality checks (ruff, mypy, 100% coverage)
4. COMMIT: Conventional commits format

Commit Format

type(scope): description

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Types: feat, fix, docs, test, refactor, build, chore

Core Domain Concepts

Multi-Timeframe Trend Alignment

Higher TF	Lower TF	Action
UP	DOWN	GO LONG (buy the dip)
DOWN	UP	GO SHORT (sell the rally)
Same	Same	STAND ASIDE

Signal Bar Rules

• BUY: Close > Open AND Close > Fibonacci Level
• SELL: Close < Open AND Close < Fibonacci Level

Position Sizing

Position Size = Risk Capital / (Entry Price - Stop Loss Price)

Roadmap

1. ✅ Core Fibonacci calculations with API
2. ✅ Signal bar detection with Type 1/2
3. ✅ Harmonic pattern detection (Gartley, Butterfly, Bat, Crab)
4. ✅ Harmonic pattern API endpoints
5. ✅ Frontend with TradingView Lightweight Charts
6. ✅ Yahoo Finance market data integration
7. ✅ Auto-refresh with market status display
8. ✅ Connect frontend to backend API for Fibonacci/signals
9. ✅ Position sizing calculator with risk management
10. ✅ Configurable pivot point detection
11. ✅ Multi-timeframe trend alignment analysis
12. ✅ Real-time pattern scanner (Signal + Harmonic)
13. ✅ 8-step trading workflow with state management
14. ✅ Multi-timeframe viewer with trends and OHLC
15. ✅ Centralized market data provider with caching
16. 🔄 Trade journaling and analytics (backend complete)
17. ⬜ Broker integration

Documentation

All documentation is centralized in the docs/ folder:

Folder	Description
docs/backend/	Backend technical documentation
docs/frontend/	Frontend technical documentation
docs/adr/	Architecture Decision Records
docs/references/	Strategy knowledge and specifications
pinescript/	TradingView Pine Script indicators

API Docs: Run server and visit /docs for interactive OpenAPI documentation.

Contributing

See the TDD workflow above. Maintain 100% test coverage and pass all linting checks before committing.