redfolder 1.0.0

Async economic calendar client and automated trading blackout engine for algorithmic traders and prop firms
Documentation 
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

//! Prop Firm Challenge Guard Example.
//!
//! Demonstrates how to configure and enforce strict prop firm news trading rules
//! (such as FTMO, FundedNext, and The5ers rules):
//! - No trading 5 minutes before and after High-Impact ("Red Folder") events.
//! - Curfew during weekend market close.

use redfolder::calendar::CalendarClient;
use redfolder::config::RedFolderConfig;
use redfolder::engine::BlackoutEngine;
use redfolder::error::Result;

#[tokio::main]
async fn main() -> Result<()> {
    // 1. Initialize client
    let client = CalendarClient::new(None);
    let events = client.fetch_or_cached().await?;

    // 2. Use the built-in prop firm preset:
    //    - 8 major currencies (USD, EUR, GBP, JPY, CAD, AUD, NZD, CHF)
    //    - High-impact events only
    //    - 5-minute pre/post event blackout windows
    //    - Weekend market close curfew until Monday 00:00 UTC
    let prop_config = RedFolderConfig::prop_firm_strict();

    println!("--- RedFolder Prop Firm Risk Guard ---");
    println!("Currencies monitored: {:?}", prop_config.currencies);
    println!(
        "Buffer: {}m before, {}m after",
        prop_config.before_min, prop_config.after_min
    );
    println!("Weekend Curfew Mode: {}", prop_config.weekend_mode);

    let engine = BlackoutEngine::compile(&events, &[&prop_config], chrono::Utc::now());

    // 3. Simulated order placement check
    let test_symbols = [("EURUSD", "EUR"), ("GBPUSD", "GBP"), ("USDJPY", "JPY")];

    for (symbol, currency) in test_symbols {
        let pair_cfg = RedFolderConfig::builder()
            .currencies(vec![currency.to_string(), "USD".to_string()])
            .impacts(vec!["High"])
            .buffer_minutes(5, 5)
            .build();

        if let Some(win) = engine.status(&pair_cfg) {
            println!(
                "⛔ REJECT ORDER on {}: Active Red Folder news blackout ({}). Ends in {}m.",
                symbol,
                win.summary_title(),
                win.remaining_minutes()
            );
        } else {
            println!("✅ ALLOW ORDER on {}: Clear to execute.", symbol);
        }
    }

    Ok(())
}