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

//! Models for SEC filings endpoints

use serde::{Deserialize, Serialize};

/// SEC Filing information
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct SecFiling {
    /// Stock symbol
    pub symbol: String,
    /// CIK number
    pub cik: Option<String>,
    /// Accepted date
    pub accepted_date: Option<String>,
    /// Filing date
    pub filing_date: Option<String>,
    /// Report date
    pub report_date: Option<String>,
    /// Form type (e.g., "10-K", "10-Q", "8-K")
    #[serde(rename = "type")]
    pub filing_type: Option<String>,
    /// Document link
    pub link: Option<String>,
    /// Final link
    pub final_link: Option<String>,
}

/// RSS Feed item for SEC filings
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct SecFilingRss {
    /// Filing title
    pub title: Option<String>,
    /// Publication date
    pub date: Option<String>,
    /// Link to filing
    pub link: Option<String>,
    /// Stock symbol
    pub symbol: Option<String>,
    /// CIK number
    pub cik: Option<String>,
    /// Form type
    pub form_type: Option<String>,
}

/// Form 13F filing data (institutional holdings)
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Form13F {
    /// Filing date
    pub date: Option<String>,
    /// Date submitted
    pub date_submitted: Option<String>,
    /// CIK number
    pub cik: Option<String>,
    /// Cusip
    pub cusip: Option<String>,
    /// Stock symbol
    pub symbol: Option<String>,
    /// Company name
    pub name_of_issuer: Option<String>,
    /// Number of shares
    pub shares: Option<i64>,
    /// Market value
    pub market_value: Option<f64>,
    /// Share price calculation
    pub share_price_calc: Option<f64>,
}

/// Insider ownership from Form 3, 4, 5
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct InsiderOwnership {
    /// Filing date
    pub filing_date: Option<String>,
    /// Transaction date
    pub transaction_date: Option<String>,
    /// Stock symbol
    pub symbol: String,
    /// CIK number
    pub cik: Option<String>,
    /// Reporting owner name
    pub reporting_name: Option<String>,
    /// Transaction type
    pub transaction_type: Option<String>,
    /// Securities owned
    pub securities_owned: Option<i64>,
    /// Securities transacted
    pub securities_transacted: Option<i64>,
    /// Transaction price per share
    pub price: Option<f64>,
    /// Link to filing
    pub link: Option<String>,
}

/// Form 4 filing (Statement of Changes in Beneficial Ownership)
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Form4 {
    /// Accepted date
    pub accepted_date: Option<String>,
    /// Filing date
    pub filing_date: Option<String>,
    /// Transaction date
    pub transaction_date: Option<String>,
    /// Stock symbol
    pub symbol: String,
    /// CIK number
    pub cik: Option<String>,
    /// Reporting name
    pub reporting_name: Option<String>,
    /// Transaction type
    pub transaction_type: Option<String>,
    /// Securities transacted
    pub securities_transacted: Option<f64>,
    /// Transaction price
    pub price: Option<f64>,
    /// Securities owned
    pub securities_owned: Option<f64>,
    /// Link to filing
    pub link: Option<String>,
}

/// CIK search result
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct CikSearch {
    /// CIK number
    pub cik: String,
    /// Company name
    pub name: Option<String>,
}

/// Company name by CIK
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct CompanyName {
    /// CIK number
    pub cik: String,
    /// Company name
    pub name: String,
}