finance-query 2.8.0

A Rust library for querying financial data
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
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

//! Compile tests for docs/library/futures.md
//!
//! Run: cargo test --test doc_futures --features polygon
//!
//! Runtime behavior of the futures quote path is covered without network
//! access by the mock + unit tests in `src/adapters/polygon/futures/snapshots.rs`
//! (mocked HTTP → DTO → canonical `FuturesQuote`).

#![cfg(feature = "polygon")]

use finance_query::FuturesQuote;

// ---------------------------------------------------------------------------
// FuturesQuote — compile-time field verification
// ---------------------------------------------------------------------------

/// Verifies all FuturesQuote fields documented in futures.md exist with correct
/// types. Never called; exists only for the compiler to type-check.
#[allow(dead_code)]
fn _verify_futures_quote_fields(q: FuturesQuote) {
    let _: String = q.symbol;
    let _: Option<String> = q.name;
    let _: Option<String> = q.underlying;
    let _: Option<String> = q.exchange;
    let _: Option<String> = q.expiration_date;
    let _: Option<f64> = q.price;
    let _: Option<f64> = q.change;
    let _: Option<f64> = q.change_percent;
    let _: Option<u64> = q.open_interest;
    let _: Option<u64> = q.volume;
    let _: Option<i64> = q.timestamp;
}

// ---------------------------------------------------------------------------
// Compile-time: handle API — mirrors the "Getting a Handle" block in futures.md
// ---------------------------------------------------------------------------

/// Verifies the documented `FuturesContract` flow type-checks: routing setup,
/// `quote()`, `chart()`, `history()`.
/// Never called; exists only for the compiler to type-check. Runtime behavior
/// is covered by the mock + unit tests in
/// `src/adapters/polygon/futures/snapshots.rs`.
#[allow(dead_code)]
async fn _verify_futures_contract_api() -> finance_query::Result<()> {
    use finance_query::{Capability, Interval, Provider, Providers, TimeRange};

    let providers = Providers::builder()
        .route(Capability::FUTURES, [Provider::Polygon])
        .build()
        .await?;

    let contract = providers.futures("ES");
    let _quote: FuturesQuote = contract.quote().await?;
    let _chart: finance_query::Chart = contract
        .chart(Interval::OneDay, TimeRange::OneMonth)
        .await?;
    let _history: finance_query::Chart = contract.history(TimeRange::OneMonth).await?;
    Ok(())
}

// ---------------------------------------------------------------------------
// Compile-time: Indicators & Risk section of futures.md
// ---------------------------------------------------------------------------

/// Verifies the documented `FuturesContract::indicators`/`indicator`/`risk`
/// flow type-checks. Never called; exists only for the compiler to type-check.
#[allow(dead_code)]
#[cfg(all(feature = "indicators", feature = "risk"))]
async fn _verify_futures_contract_indicators_and_risk() -> finance_query::Result<()> {
    use finance_query::indicators::Indicator;
    use finance_query::{Capability, Interval, Provider, Providers, TimeRange};

    let providers = Providers::builder()
        .route(Capability::FUTURES, [Provider::Polygon])
        .build()
        .await?;
    let contract = providers.futures("ES");

    let summary = contract
        .indicators(Interval::OneDay, TimeRange::ThreeMonths)
        .await?;
    let _: Option<f64> = summary.rsi_14;

    let _rsi_21 = contract
        .indicator(Indicator::Rsi(21), Interval::OneDay, TimeRange::ThreeMonths)
        .await?;

    let risk = contract.risk(Interval::OneDay, TimeRange::OneYear).await?;
    let _: f64 = risk.var_95;
    let _: f64 = risk.max_drawdown;

    Ok(())
}