fmp-rs 0.1.1

Production-grade Rust client for Financial Modeling Prep API with intelligent caching, rate limiting, and comprehensive endpoint coverage
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
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233

//! Models for bulk data endpoints

use serde::{Deserialize, Serialize};

/// Bulk stock prices data
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct BulkStockPrice {
    /// Stock symbol
    pub symbol: Option<String>,
    /// Company name
    pub name: Option<String>,
    /// Current price
    pub price: Option<f64>,
    /// Price change
    pub change: Option<f64>,
    /// Percentage change
    pub changes_percentage: Option<f64>,
    /// Day low
    pub day_low: Option<f64>,
    /// Day high
    pub day_high: Option<f64>,
    /// Year low
    pub year_low: Option<f64>,
    /// Year high
    pub year_high: Option<f64>,
    /// Market capitalization
    pub market_cap: Option<f64>,
    /// Price to earnings ratio
    pub pe: Option<f64>,
    /// Volume
    pub volume: Option<i64>,
    /// Average volume
    pub avg_volume: Option<i64>,
    /// Exchange
    pub exchange: Option<String>,
    /// Open price
    pub open: Option<f64>,
    /// Previous close
    pub previous_close: Option<f64>,
    /// Earnings per share
    pub eps: Option<f64>,
    /// Shares outstanding
    pub shares_outstanding: Option<i64>,
    /// Timestamp
    pub timestamp: Option<i64>,
}

/// Bulk financial statements
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct BulkFinancialStatement {
    /// Stock symbol
    pub symbol: Option<String>,
    /// Date of the financial statement
    pub date: Option<String>,
    /// Calendar year
    pub calendar_year: Option<String>,
    /// Period (annual, quarterly)
    pub period: Option<String>,
    /// Revenue
    pub revenue: Option<f64>,
    /// Cost of revenue
    pub cost_of_revenue: Option<f64>,
    /// Gross profit
    pub gross_profit: Option<f64>,
    /// Operating income
    pub operating_income: Option<f64>,
    /// Net income
    pub net_income: Option<f64>,
    /// Total assets
    pub total_assets: Option<f64>,
    /// Total liabilities
    pub total_liabilities: Option<f64>,
    /// Total stockholders equity
    pub total_stockholders_equity: Option<f64>,
    /// Operating cash flow
    pub operating_cash_flow: Option<f64>,
    /// Free cash flow
    pub free_cash_flow: Option<f64>,
    /// Total debt
    pub total_debt: Option<f64>,
    /// Cash and cash equivalents
    pub cash_and_cash_equivalents: Option<f64>,
}

/// Bulk ETF holdings data
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct BulkEtfHolding {
    /// ETF symbol
    pub etf_symbol: Option<String>,
    /// Holding symbol
    pub asset_symbol: Option<String>,
    /// Asset name
    pub name: Option<String>,
    /// Number of shares held
    pub shares_number: Option<f64>,
    /// Market value of holding
    pub market_value: Option<f64>,
    /// Weight in the ETF
    pub weight_percentage: Option<f64>,
    /// Updated date
    pub updated: Option<String>,
}

/// Bulk insider trading data
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct BulkInsiderTrade {
    /// Filing date
    pub filing_date: Option<String>,
    /// Transaction date
    pub transaction_date: Option<String>,
    /// Reporting CIK
    pub reporting_cik: Option<String>,
    /// Transaction type
    pub transaction_type: Option<String>,
    /// Securities owned
    pub securities_owned: Option<f64>,
    /// Company CIK
    pub company_cik: Option<String>,
    /// Company name
    pub company_name: Option<String>,
    /// Securities transacted
    pub securities_transacted: Option<f64>,
    /// Price
    pub price: Option<f64>,
    /// Security name
    pub security_name: Option<String>,
    /// CIK
    pub cik: Option<String>,
    /// Symbol
    pub symbol: Option<String>,
    /// Transaction value
    pub transaction_value: Option<f64>,
}

/// Bulk institutional holdings
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct BulkInstitutionalHolding {
    /// Filing date
    pub date_reported: Option<String>,
    /// CIK of the institution
    pub cik: Option<String>,
    /// Institution name
    pub name_of_issuer: Option<String>,
    /// Ticker symbol
    pub ticker_symbol: Option<String>,
    /// CUSIP
    pub cusip: Option<String>,
    /// Value of holding
    pub value: Option<f64>,
    /// Number of shares
    pub shares: Option<f64>,
    /// Put/call indicator
    pub put_call: Option<String>,
    /// Investment discretion
    pub investment_discretion: Option<String>,
    /// Sole voting authority
    pub sole_voting_authority: Option<f64>,
    /// Shared voting authority
    pub shared_voting_authority: Option<f64>,
    /// No voting authority
    pub no_voting_authority: Option<f64>,
}

/// Bulk earnings estimates
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct BulkEarningsEstimate {
    /// Symbol
    pub symbol: Option<String>,
    /// Date
    pub date: Option<String>,
    /// Estimated revenue low
    pub estimated_revenue_low: Option<f64>,
    /// Estimated revenue high
    pub estimated_revenue_high: Option<f64>,
    /// Estimated revenue avg
    pub estimated_revenue_avg: Option<f64>,
    /// Estimated EPS avg
    pub estimated_eps_avg: Option<f64>,
    /// Estimated EPS high
    pub estimated_eps_high: Option<f64>,
    /// Estimated EPS low
    pub estimated_eps_low: Option<f64>,
    /// Number of analysts
    pub number_analyst_estimated_revenue: Option<i32>,
    /// Number of EPS analysts
    pub number_analyst_estimated_eps: Option<i32>,
}

/// Bulk download information/metadata
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct BulkDataInfo {
    /// Dataset name
    pub dataset: Option<String>,
    /// Last updated timestamp
    pub last_updated: Option<String>,
    /// File size in bytes
    pub file_size: Option<i64>,
    /// Number of records
    pub record_count: Option<i64>,
    /// Download URL
    pub download_url: Option<String>,
    /// Format (CSV, JSON, etc.)
    pub format: Option<String>,
    /// Compression type
    pub compression: Option<String>,
    /// Schema version
    pub schema_version: Option<String>,
}

/// Bulk historical prices metadata
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct BulkHistoricalPricesMeta {
    /// Date range start
    pub date_from: Option<String>,
    /// Date range end
    pub date_to: Option<String>,
    /// Symbols included count
    pub symbols_count: Option<i32>,
    /// Total data points
    pub total_records: Option<i64>,
    /// File format
    pub file_format: Option<String>,
    /// Estimated download size
    pub estimated_size_mb: Option<f64>,
}