causal_model_btc/model_documentation.html at main · algomaschine/causal_model_btc · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Methodology: The 'Helios' Adaptive Trading Model</title>
    <style>
        body { font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif; line-height: 1.6; margin: 0; padding: 0; background-color: #f9f9f9; color: #333; }
        .container { max-width: 900px; margin: 20px auto; padding: 25px; background-color: #fff; border-radius: 8px; box-shadow: 0 4px 8px rgba(0,0,0,0.05); }
        h1, h2, h3 { color: #2c3e50; border-bottom: 2px solid #3498db; padding-bottom: 10px; }
        h1 { font-size: 2.2em; text-align: center; border-bottom: none; margin-bottom: 20px;}
        h2 { font-size: 1.8em; margin-top: 40px; }
        h3 { font-size: 1.4em; border-bottom: 1px solid #bdc3c7; color: #34495e; }
        p { margin-bottom: 15px; }
        ul { list-style-type: disc; padding-left: 20px; }
        li { margin-bottom: 10px; }
        code { background-color: #ecf0f1; color: #2c3e50; padding: 3px 6px; border-radius: 4px; font-family: 'Courier New', Courier, monospace; }
        pre { background-color: #2c3e50; color: #ecf0f1; padding: 15px; border-radius: 5px; white-space: pre-wrap; word-wrap: break-word; font-family: 'Courier New', Courier, monospace; }
        .step { background-color: #ffffff; border-left: 5px solid #3498db; padding: 20px; margin: 25px 0; box-shadow: 0 2px 4px rgba(0,0,0,0.05); }
        .rationale { background-color: #eaf5fc; border-left: 5px solid #2980b9; padding: 15px; margin-top: 10px; border-radius: 5px; }
        .rationale strong { color: #2980b9; }
        strong { color: #2c3e50; }
        .summary { text-align: center; font-size: 1.1em; color: #555; margin-bottom: 30px; }
    </style>
</head>
<body>
    <div class="container">
        <h1>Executive Summary & Methodology<br/>The 'Helios' Adaptive Trading Model</h1>
        <p class="summary">This document outlines the architecture of the <strong>Helios Adaptive Trading Model</strong>, a proprietary quantitative strategy designed to navigate complex market conditions by dynamically learning and adapting. It moves beyond simple prediction to offer a sophisticated framework for risk allocation and strategy generation.</p>

        <h2>Core Philosophy: A New Standard in Strategy Design</h2>
        <ul>
            <li><strong>Realistic Performance Simulation:</strong> Our methodology rigorously simulates real-world trading conditions. This ensures that all performance metrics are based on realistic, historical 'out-of-sample' data, providing a true measure of the strategy's potential.</li>
            <li><strong>Institutional-Grade Integrity:</strong> The system is built from the ground up to prevent data snooping and lookahead bias. Every calculation is performed in a chronologically correct manner, safeguarding the integrity of results and preventing illusions of false profitability.</li>
            <li><strong>Dynamic Market Adaptation Engine:</strong> The core of the Helios model is its ability to evolve. On a monthly basis, the model re-evaluates the entire market landscape, identifies the most predictive economic drivers, and retrains itself. This ensures the strategy remains relevant and effective, adapting to new market regimes and volatility shifts.</li>
            <li><strong>High-Resolution Market Forecasting:</strong> Instead of a crude 'buy' or 'sell' signal, Helios classifies the market into five distinct states (e.g., 'strong downtrend' to 'strong uptrend'). This provides a high-resolution forecast, enabling a more sophisticated and precise approach to capital allocation.</li>
        </ul>

        <h2>Key Business Advantages</h2>
         <ul>
            <li><strong>On-Demand Asset Analysis:</strong> Run a complete historical simulation for any asset in our universe—FX, commodities, digital assets—with a single command. This allows for rapid hypothesis testing and strategy evaluation across different markets.</li>
            <li><strong>Seamless Data Integration:</strong> The system's flexible data ingestion engine automatically locates and integrates the necessary data for any target asset, removing manual setup and accelerating the research cycle.</li>
            <li><strong>A Future-Proof Strategy:</strong> The adaptive core ensures the strategy does not degrade over time but rather evolves and improves as it learns from new market data, turning market shifts into opportunities.</li>
        </ul>

        <div class="step">
            <h2>Step 1: Foundation - Data Ingestion & Integration</h2>
            <h3>Explanation</h3>
            <p>The pipeline begins by ingesting and synchronizing multiple data streams. It intelligently identifies the primary data for the target asset—whether it's an FX pair, a commodity, or a digital asset like BTC—from our centralized feature repository or dedicated price feeds. This flexible architecture ensures seamless integration with diverse data sources and allows for rapid onboarding of new assets.</p>
            <h3>Pseudocode</h3>
            <pre>
FUNCTION load_and_prepare_data(target_asset):
    features_df = LOAD_CSV("central_feature_repository.csv")
    prices_df = LOAD_CSV("dedicated_price_feeds.csv")

    target_column_name = GET_COLUMN_NAME(target_asset, "_close")

    // Intelligently locate the target asset's primary data
    IF target_column_name is in features_df THEN
        // Use feature file as base, merge in other unique price data
        price_cols_to_add = GET_UNIQUE_COLUMNS(prices_df, features_df)
        merged_df = MERGE(features_df, prices_df[price_cols_to_add], ON="Date")
    ELSE IF target_column_name is in prices_df THEN
        // Use price file for the target, merge with all features
        merged_df = MERGE(features_df, prices_df, ON="Date")
    ELSE
        THROW ERROR("Target asset not found in data sources.")
    END IF

    SORT(merged_df, BY="Date")

    // Align today's data with tomorrow's outcome for training
    merged_df["target_future_price"] = SHIFT(merged_df[target_column_name], BY=-1)
    DROP_NAN(merged_df, SUBSET=["target_future_price"])

    RETURN merged_df
END FUNCTION
            </pre>
        </div>

        <div class="step">
            <h2>Step 2: The Simulation Core - Chronological Walk-Forward Engine</h2>
            <h3>Explanation</h3>
            <p>The engine simulates the passage of time, processing market data one day at a time. This chronological progression is the bedrock of our commitment to realistic backtesting, ensuring that every decision made by the model is based solely on information that would have been available at that precise moment in history.</p>
        </div>

        <div class="step">
            <h2>Step 3: Intelligence Augmentation - Dynamic Feature Creation</h2>
            <h3>Explanation</h3>
            <p>On each retraining cycle, the system doesn't just look at raw data; it creates a rich, multi-dimensional view of the market. It generates hundreds of proprietary 'smart features' that capture complex concepts like momentum, trend-strength, and volatility acceleration across all market drivers. This serves as an intelligence layer, allowing the model to understand the deeper context of market behavior.</p>
            <div class="rationale">
                <strong>Our Edge:</strong> This pre-processing allows the core algorithm to focus on finding complex, non-linear relationships, rather than wasting resources learning basic market dynamics. We tell the model *what* to look for, so it can tell us *what matters*.
            </div>
        </div>

        <div class="step">
            <h2>Step 4: Defining Opportunity - Adaptive Target Engineering</h2>
            <h3>Explanation</h3>
            <p>Our system redefines what constitutes a trading opportunity on a monthly basis. Using advanced statistical techniques, it creates five distinct market states. This process is adaptive; the definition of a 'strong move' automatically adjusts to recent market volatility, preventing the strategy from becoming too aggressive in calm markets or too timid in volatile ones.</p>
            <div class="rationale">
                <strong>Our Edge:</strong> This creates a stable, consistent target for the model to learn, improving signal clarity and leading to more reliable performance across different market regimes.
            </div>
        </div>

        <div class="step">
            <h2>Step 5: The Learning Cycle - Monthly Strategy Refinement</h2>
            <h3>Explanation</h3>
            <p>At the end of each month, the model undergoes a full 'strategy refinement' cycle. It conducts a comprehensive analysis of all available data to identify the handful of market drivers that were most predictive in the recent past. Before this, a crucial data integrity check is performed: the system ensures the historical data for the period is diverse enough to contain examples of all five market states. If the market has been too calm or one-sided, the model intelligently defers retraining and continues to operate with its existing parameters until a more representative dataset is available. A new, optimized XGBoost model is then trained using only an elite subset of features. This is our core adaptive mechanism, ensuring the strategy automatically discards irrelevant information and focuses on what is currently driving the market.</p>
        </div>

        <div class="step">
            <h2>Step 6: Execution Logic - Probabilistic Sizing & Risk Allocation</h2>
            <h3>Explanation</h3>
            <p>Daily execution is not based on a simple 'on/off' signal. The model outputs a full probability distribution across all five market states. We then translate this into a single, actionable 'conviction score' using an Expected Value framework. This score dictates both the direction and, crucially, the <strong>size</strong> of the position. This allows for dynamic capital allocation—deploying more capital when the model has high conviction in a strong move, and reducing exposure during periods of uncertainty.</p>
             <div class="rationale">
                <strong>Our Edge:</strong> This "Expected Value" approach is superior to just taking the most likely outcome. It fully utilizes the nuanced output of the model, leading to more intelligent risk-taking and sophisticated capital deployment.
            </div>
        </div>

        <h2>Operational Agility & Scalability</h2>
        <p>The Helios pipeline is designed for scalability and rapid deployment. The entire backtesting process for any asset can be initiated via a single command-line instruction, allowing analysts and portfolio managers to test new hypotheses or evaluate strategies on different instruments with unprecedented speed. This 'on-demand' analysis capability dramatically shortens the research-to-insight cycle, providing a powerful competitive edge.</p>

    </div>
</body>
</html>