EPIC: Phase 3 - Position Risk Quantification
Epic ID: EPIC-003
Status: Planned
Priority: P1
Estimated Effort: 30-40 hours
Dependencies: Phase 2 (Exit Strategy Complete)
Target Completion: 2026-04-01
Epic Overview
Add real position tracking and capital risk calculations to enhance notifications with actionable risk metrics. Currently, risk assessment only looks at configuration, not actual positions. This phase integrates with KuCoin API to fetch real position data and calculate capital at risk.
Goals
- Fetch actual open orders from KuCoin API
- Calculate unrealized P&L based on current positions
- Quantify capital at risk if stop-loss hit
- Estimate profit giveback based on delay in exit
- Enhance notifications with risk metrics
Key Stories (Outline)
Story 3.1: KuCoin Position Tracker (8-12h)
- Fetch active grid orders from KuCoin API
- Calculate unrealized P&L
- Calculate inventory imbalance
- Handle API errors gracefully
Story 3.2: Capital Risk Calculator (6-8h)
- Calculate capital at risk formula
- Estimate profit giveback ranges
- Calculate stop-loss distance in ATR units
- Configurable risk thresholds
Story 3.3: Enhanced Notifications (4-6h)
- Add risk metrics to notification messages
- Format risk data for readability
- Priority adjustment based on risk level
- Examples: “Capital at risk: $120.50”
Story 3.4: Integration & Testing (8-12h)
- Wire risk calculations into notification flow
- Mock KuCoin API for testing
- Integration tests with real position data
- Performance validation
Story 3.5: Configuration & Documentation (4-6h)
- Risk calculation configuration
- API integration documentation
- Notification format examples
Success Criteria
- ✅ Real position data fetched from KuCoin
- ✅ Notifications include capital at risk metrics
- ✅ Accurate P&L calculations (validated against KuCoin UI)
- ✅ 90%+ test coverage
- ✅ Graceful handling of API failures
Epic Owner: Craig
Created: 2026-02-01
Status: Outline - will be detailed after Phase 2 completion