improved data structure
This commit is contained in:
Dobromir Popov
526
docs/CANDLE_TA_VISUAL_GUIDE.md
Normal file
526
docs/CANDLE_TA_VISUAL_GUIDE.md
Normal file
@@ -0,0 +1,526 @@
|
||||
# Candle TA Features Visual Guide
|
||||
|
||||
## Candle Anatomy
|
||||
|
||||
```
|
||||
High (2050)
|
||||
│
|
||||
├─── Upper Wick (10)
|
||||
│
|
||||
┌─────────────┴─────────────┐
|
||||
│ │
|
||||
│ Body (40) │ Close (2040) - Bullish
|
||||
│ │
|
||||
└─────────────┬─────────────┘
|
||||
│
|
||||
├─── Lower Wick (10)
|
||||
│
|
||||
Low (1990)
|
||||
|
||||
Open (2000)
|
||||
|
||||
Total Range = High - Low = 60
|
||||
Body Size = |Close - Open| = 40
|
||||
Upper Wick = High - max(Open, Close) = 10
|
||||
Lower Wick = min(Open, Close) - Low = 10
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Candle Types
|
||||
|
||||
### Bullish Candle (Hollow/Green)
|
||||
```
|
||||
Close > Open
|
||||
|
||||
High
|
||||
│
|
||||
├─── Upper Wick
|
||||
│
|
||||
┌─┴─┐
|
||||
│ │ Body (hollow)
|
||||
│ │ Close at top
|
||||
└─┬─┘
|
||||
│
|
||||
├─── Lower Wick
|
||||
│
|
||||
Low
|
||||
|
||||
Open
|
||||
```
|
||||
|
||||
### Bearish Candle (Solid/Red)
|
||||
```
|
||||
Close < Open
|
||||
|
||||
High
|
||||
│
|
||||
├─── Upper Wick
|
||||
│
|
||||
┌─┴─┐
|
||||
│▓▓▓│ Body (solid)
|
||||
│▓▓▓│ Open at top
|
||||
└─┬─┘
|
||||
│
|
||||
├─── Lower Wick
|
||||
│
|
||||
Low
|
||||
|
||||
Close
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Pattern Recognition
|
||||
|
||||
### 1. Doji (Indecision)
|
||||
```
|
||||
Body < 10% of range
|
||||
|
||||
High
|
||||
│
|
||||
├─── Long upper wick
|
||||
│
|
||||
─┼─ Tiny body
|
||||
│
|
||||
├─── Long lower wick
|
||||
│
|
||||
Low
|
||||
|
||||
Signal: Indecision, potential reversal
|
||||
```
|
||||
|
||||
### 2. Hammer (Bullish Reversal)
|
||||
```
|
||||
Small body at top, long lower wick
|
||||
|
||||
High
|
||||
│
|
||||
┌─┴─┐
|
||||
│ │ Small body
|
||||
└─┬─┘
|
||||
│
|
||||
│
|
||||
├─── Very long lower wick
|
||||
│
|
||||
│
|
||||
Low
|
||||
|
||||
Signal: Bullish reversal (after downtrend)
|
||||
Criteria: body < 30%, lower wick > 60%
|
||||
```
|
||||
|
||||
### 3. Shooting Star (Bearish Reversal)
|
||||
```
|
||||
Small body at bottom, long upper wick
|
||||
|
||||
High
|
||||
│
|
||||
│
|
||||
├─── Very long upper wick
|
||||
│
|
||||
│
|
||||
┌─┴─┐
|
||||
│▓▓▓│ Small body
|
||||
└─┬─┘
|
||||
│
|
||||
Low
|
||||
|
||||
Signal: Bearish reversal (after uptrend)
|
||||
Criteria: body < 30%, upper wick > 60%
|
||||
```
|
||||
|
||||
### 4. Spinning Top (Indecision)
|
||||
```
|
||||
Small body, both wicks present
|
||||
|
||||
High
|
||||
│
|
||||
├─── Upper wick
|
||||
│
|
||||
┌─┴─┐
|
||||
│ │ Small body
|
||||
└─┬─┘
|
||||
│
|
||||
├─── Lower wick
|
||||
│
|
||||
Low
|
||||
|
||||
Signal: Indecision, consolidation
|
||||
Criteria: body < 30%, wicks > 60%
|
||||
```
|
||||
|
||||
### 5. Marubozu Bullish (Strong Momentum)
|
||||
```
|
||||
Large body, minimal wicks
|
||||
|
||||
High ─┐
|
||||
│
|
||||
│
|
||||
│ Large body (>90%)
|
||||
│ Strong bullish
|
||||
│
|
||||
│
|
||||
Low ─┘
|
||||
|
||||
Signal: Strong bullish momentum
|
||||
Criteria: body > 90% of range
|
||||
```
|
||||
|
||||
### 6. Marubozu Bearish (Strong Momentum)
|
||||
```
|
||||
Large body, minimal wicks
|
||||
|
||||
High ─┐
|
||||
│
|
||||
│
|
||||
│ Large body (>90%)
|
||||
│ Strong bearish
|
||||
│
|
||||
│
|
||||
Low ─┘
|
||||
|
||||
Signal: Strong bearish momentum
|
||||
Criteria: body > 90% of range
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Relative Sizing
|
||||
|
||||
### Comparison to Previous Candles
|
||||
|
||||
```
|
||||
Last 10 candles (reference):
|
||||
|
||||
│ │ │ │ │ │ │ │ │ │ Current
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓ ▓
|
||||
|
||||
Average range: 20 points
|
||||
Current range: 60 points
|
||||
Relative size: 3.0 (3x larger!)
|
||||
|
||||
Signal: Unusually large candle = momentum/breakout
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Feature Vector Structure
|
||||
|
||||
### Standard Mode (7,850 features)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ OHLCV ETH (6,000 features) │
|
||||
│ ┌─────────────────────────────────────────────────────┐ │
|
||||
│ │ 1s: 300 candles × 5 values = 1,500 │ │
|
||||
│ │ 1m: 300 candles × 5 values = 1,500 │ │
|
||||
│ │ 1h: 300 candles × 5 values = 1,500 │ │
|
||||
│ │ 1d: 300 candles × 5 values = 1,500 │ │
|
||||
│ └─────────────────────────────────────────────────────┘ │
|
||||
├─────────────────────────────────────────────────────────┤
|
||||
│ OHLCV BTC (1,500 features) │
|
||||
│ ┌─────────────────────────────────────────────────────┐ │
|
||||
│ │ 1s: 300 candles × 5 values = 1,500 │ │
|
||||
│ └─────────────────────────────────────────────────────┘ │
|
||||
├─────────────────────────────────────────────────────────┤
|
||||
│ COB Features (200) │
|
||||
│ Technical Indicators (100) │
|
||||
│ Last Predictions (45) │
|
||||
│ Position Info (5) │
|
||||
└─────────────────────────────────────────────────────────┘
|
||||
Total: 7,850 features
|
||||
```
|
||||
|
||||
### Enhanced Mode (22,850 features)
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ OHLCV ETH + TA (18,000 features) │
|
||||
│ ┌─────────────────────────────────────────────────────┐ │
|
||||
│ │ 1s: 300 × 15 (5 OHLCV + 10 TA) = 4,500 │ │
|
||||
│ │ 1m: 300 × 15 (5 OHLCV + 10 TA) = 4,500 │ │
|
||||
│ │ 1h: 300 × 15 (5 OHLCV + 10 TA) = 4,500 │ │
|
||||
│ │ 1d: 300 × 15 (5 OHLCV + 10 TA) = 4,500 │ │
|
||||
│ └─────────────────────────────────────────────────────┘ │
|
||||
├─────────────────────────────────────────────────────────┤
|
||||
│ OHLCV BTC + TA (4,500 features) │
|
||||
│ ┌─────────────────────────────────────────────────────┐ │
|
||||
│ │ 1s: 300 × 15 (5 OHLCV + 10 TA) = 4,500 │ │
|
||||
│ └─────────────────────────────────────────────────────┘ │
|
||||
├─────────────────────────────────────────────────────────┤
|
||||
│ COB Features (200) │
|
||||
│ Technical Indicators (100) │
|
||||
│ Last Predictions (45) │
|
||||
│ Position Info (5) │
|
||||
└─────────────────────────────────────────────────────────┘
|
||||
Total: 22,850 features
|
||||
|
||||
10 TA Features per candle:
|
||||
1. is_bullish
|
||||
2. body_to_range_ratio
|
||||
3. upper_wick_ratio
|
||||
4. lower_wick_ratio
|
||||
5. body_size_pct
|
||||
6. total_range_pct
|
||||
7. relative_size_avg
|
||||
8. pattern_doji
|
||||
9. pattern_hammer
|
||||
10. pattern_shooting_star
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Ratio Calculations
|
||||
|
||||
### Body to Range Ratio
|
||||
|
||||
```
|
||||
Example 1: Strong Body (Marubozu)
|
||||
High (2050)
|
||||
┌─┴─┐
|
||||
│ │
|
||||
│ │ Body = 48
|
||||
│ │ Range = 50
|
||||
│ │ Ratio = 0.96 (96%)
|
||||
│ │
|
||||
└─┬─┘
|
||||
Low (2000)
|
||||
|
||||
Example 2: Small Body (Doji)
|
||||
High (2050)
|
||||
│
|
||||
│
|
||||
─┼─ Body = 2
|
||||
│ Range = 50
|
||||
│ Ratio = 0.04 (4%)
|
||||
│
|
||||
Low (2000)
|
||||
|
||||
Example 3: Medium Body (Standard)
|
||||
High (2050)
|
||||
│
|
||||
┌─┴─┐
|
||||
│ │ Body = 25
|
||||
│ │ Range = 50
|
||||
└─┬─┘ Ratio = 0.50 (50%)
|
||||
│
|
||||
Low (2000)
|
||||
```
|
||||
|
||||
### Wick Ratios
|
||||
|
||||
```
|
||||
Example: Hammer Pattern
|
||||
|
||||
High (2050)
|
||||
│
|
||||
┌─┴─┐
|
||||
│ │ Body = 10 (20% of range)
|
||||
└─┬─┘ Upper wick = 5 (10% of range)
|
||||
│
|
||||
│
|
||||
│ Lower wick = 35 (70% of range)
|
||||
│
|
||||
│
|
||||
Low (2000)
|
||||
|
||||
Interpretation:
|
||||
- Small body at top
|
||||
- Long lower wick (rejection of lower prices)
|
||||
- Bullish reversal signal
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Real-World Example
|
||||
|
||||
### Analyzing a Trading Session
|
||||
|
||||
```
|
||||
Time Series (Last 10 candles):
|
||||
|
||||
10:00 │▓│ Standard bearish, small
|
||||
10:01 │▓│ Standard bearish, small
|
||||
10:02 │▓│ Standard bearish, small
|
||||
10:03 │▓│ Doji (indecision)
|
||||
10:04 │▓│ Standard bearish, small
|
||||
10:05 │▓│ Standard bearish, small
|
||||
10:06 │▓│ Hammer! (potential reversal)
|
||||
│ │
|
||||
│ │
|
||||
│ │
|
||||
└─┘
|
||||
10:07 │ │ Marubozu bullish (confirmation!)
|
||||
│ │
|
||||
│ │
|
||||
│ │
|
||||
│ │
|
||||
│ │
|
||||
10:08 │ │ Large bullish (momentum)
|
||||
│ │
|
||||
│ │
|
||||
│ │
|
||||
10:09 │ │ Standard bullish
|
||||
|
||||
Analysis:
|
||||
1. Downtrend (10:00-10:05)
|
||||
2. Hammer at 10:06 signals potential reversal
|
||||
3. Marubozu at 10:07 confirms reversal
|
||||
4. Large candle at 10:08 shows momentum
|
||||
5. Trend reversal confirmed!
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Feature Importance
|
||||
|
||||
### Most Valuable TA Features
|
||||
|
||||
```
|
||||
High Impact (Essential):
|
||||
┌────────────────────────────────┐
|
||||
│ 1. is_bullish │ Direction
|
||||
│ 2. body_to_range_ratio │ Strength
|
||||
│ 3. relative_size_avg │ Momentum
|
||||
└────────────────────────────────┘
|
||||
|
||||
Medium Impact (Useful):
|
||||
┌────────────────────────────────┐
|
||||
│ 4. pattern_hammer │ Reversal
|
||||
│ 5. pattern_shooting_star │ Reversal
|
||||
│ 6. pattern_doji │ Indecision
|
||||
│ 7. upper_wick_ratio │ Rejection
|
||||
│ 8. lower_wick_ratio │ Support
|
||||
└────────────────────────────────┘
|
||||
|
||||
Lower Impact (Context):
|
||||
┌────────────────────────────────┐
|
||||
│ 9. body_size_pct │ Volatility
|
||||
│ 10. total_range_pct │ Volatility
|
||||
└────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Decision Tree Example
|
||||
|
||||
```
|
||||
Is current candle unusually large?
|
||||
│
|
||||
├─ YES (relative_size > 2.0)
|
||||
│ │
|
||||
│ ├─ Is it bullish?
|
||||
│ │ │
|
||||
│ │ ├─ YES → Strong bullish momentum
|
||||
│ │ │ Action: Consider long entry
|
||||
│ │ │
|
||||
│ │ └─ NO → Strong bearish momentum
|
||||
│ │ Action: Consider short entry
|
||||
│ │
|
||||
│ └─ Is body > 80% of range?
|
||||
│ │
|
||||
│ ├─ YES → Marubozu (strong conviction)
|
||||
│ │ Action: High confidence trade
|
||||
│ │
|
||||
│ └─ NO → Large wicks (rejection)
|
||||
│ Action: Wait for confirmation
|
||||
│
|
||||
└─ NO (relative_size ≤ 2.0)
|
||||
│
|
||||
├─ Is it a hammer or shooting star?
|
||||
│ │
|
||||
│ ├─ YES → Potential reversal
|
||||
│ │ Action: Watch for confirmation
|
||||
│ │
|
||||
│ └─ NO → Continue
|
||||
│
|
||||
└─ Is it a doji?
|
||||
│
|
||||
├─ YES → Indecision
|
||||
│ Action: Wait for direction
|
||||
│
|
||||
└─ NO → Standard candle
|
||||
Action: Follow trend
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Performance Visualization
|
||||
|
||||
### Computation Time
|
||||
|
||||
```
|
||||
Standard Mode (7,850 features):
|
||||
[████████████████████] 2 ms
|
||||
|
||||
Enhanced Mode (22,850 features):
|
||||
[████████████████████████████████████████████████████████] 150 ms
|
||||
|
||||
With Caching:
|
||||
[████████████████████] 2 ms
|
||||
|
||||
Speedup: 75x faster with caching!
|
||||
```
|
||||
|
||||
### Memory Usage
|
||||
|
||||
```
|
||||
Standard Mode:
|
||||
[████] 31 KB
|
||||
|
||||
Enhanced Mode:
|
||||
[████████████] 91 KB
|
||||
|
||||
Increase: 3x
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Summary
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────┐
|
||||
│ Candle TA Features │
|
||||
├─────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ ✓ 7 Pattern Types │
|
||||
│ ✓ 22 TA Features per candle │
|
||||
│ ✓ Relative sizing (vs last 10 candles) │
|
||||
│ ✓ Body/wick ratio analysis │
|
||||
│ ✓ Backward compatible (opt-in) │
|
||||
│ ✓ Cached for performance │
|
||||
│ │
|
||||
│ Use Cases: │
|
||||
│ • Pattern recognition │
|
||||
│ • Reversal detection │
|
||||
│ • Momentum identification │
|
||||
│ • Feature engineering for ML │
|
||||
│ │
|
||||
│ Best For: │
|
||||
│ • CNN models │
|
||||
│ • Transformer models │
|
||||
│ • LSTM models │
|
||||
│ • Pattern-based strategies │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────┘
|
||||
```
|
||||
Reference in New Issue
Block a user