finance-query 2.5.1

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
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
126
127
128
129
130
131
132
133
134
135
136
137
138
139

//! Earnings Module
//!
//! Contains quarterly and annual earnings chart data.

use serde::{Deserialize, Serialize};

/// Earnings data including charts and forecasts
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Earnings {
    /// Default methodology (e.g., "gaap")
    #[serde(default)]
    pub default_methodology: Option<String>,

    /// Earnings chart data
    #[serde(default)]
    pub earnings_chart: Option<EarningsChart>,

    /// Financial chart data (revenue/earnings over time)
    #[serde(default)]
    pub financials_chart: Option<FinancialsChart>,
}

/// Earnings chart showing quarterly data
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct EarningsChart {
    /// Quarterly earnings data
    #[serde(default)]
    pub quarterly: Vec<QuarterlyEarnings>,

    /// Current quarter estimate
    #[serde(default)]
    pub current_quarter_estimate: Option<crate::models::quote::FormattedValue<f64>>,

    /// Current quarter estimate date
    #[serde(default)]
    pub current_quarter_estimate_date: Option<String>,

    /// Current quarter estimate year
    #[serde(default)]
    pub current_quarter_estimate_year: Option<i32>,

    /// Current fiscal quarter
    #[serde(default)]
    pub current_fiscal_quarter: Option<String>,

    /// Current calendar quarter
    #[serde(default)]
    pub current_calendar_quarter: Option<String>,

    /// Upcoming earnings dates
    #[serde(default)]
    pub earnings_date: Vec<crate::models::quote::FormattedValue<i64>>,

    /// Whether the earnings date is an estimate
    #[serde(default)]
    pub is_earnings_date_estimate: Option<bool>,
}

/// Quarterly earnings entry
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct QuarterlyEarnings {
    /// Date/quarter identifier
    #[serde(default)]
    pub date: Option<String>,

    /// Actual EPS
    #[serde(default)]
    pub actual: Option<crate::models::quote::FormattedValue<f64>>,

    /// Estimated EPS
    #[serde(default)]
    pub estimate: Option<crate::models::quote::FormattedValue<f64>>,

    /// Difference between actual and estimate (string format)
    #[serde(default)]
    pub difference: Option<String>,

    /// Surprise percentage (string format)
    #[serde(default)]
    pub surprise_pct: Option<String>,

    /// Calendar quarter
    #[serde(default)]
    pub calendar_quarter: Option<String>,

    /// Fiscal quarter
    #[serde(default)]
    pub fiscal_quarter: Option<String>,
}

/// Financial chart showing revenue and earnings over time
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct FinancialsChart {
    /// Yearly financial data
    #[serde(default)]
    pub yearly: Vec<YearlyFinancials>,

    /// Quarterly financial data
    #[serde(default)]
    pub quarterly: Vec<QuarterlyFinancials>,
}

/// Yearly financial data entry
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct YearlyFinancials {
    /// Date
    #[serde(default)]
    pub date: Option<i64>,

    /// Revenue
    #[serde(default)]
    pub revenue: Option<crate::models::quote::FormattedValue<i64>>,

    /// Earnings
    #[serde(default)]
    pub earnings: Option<crate::models::quote::FormattedValue<i64>>,
}

/// Quarterly financial data entry
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct QuarterlyFinancials {
    /// Date
    #[serde(default)]
    pub date: Option<String>,

    /// Revenue
    #[serde(default)]
    pub revenue: Option<crate::models::quote::FormattedValue<i64>>,

    /// Earnings
    #[serde(default)]
    pub earnings: Option<crate::models::quote::FormattedValue<i64>>,
}