libfmp 0.12.0

Async, typed Rust client for the Financial Modeling Prep API
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

//! Response models owned by discounted-cash-flow valuation endpoints.

use serde::{Deserialize, Serialize};

use crate::{
    codecs::FiscalYearString,
    types::{Date, Percentage, Price, Quantity, StatementAmount, Ticker},
};

/// One standard or levered discounted-cash-flow valuation.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[non_exhaustive]
pub struct DcfValuation {
    pub symbol: Ticker,
    pub date: Date,
    pub dcf: f64,
    #[serde(rename = "Stock Price")]
    pub stock_price: f64,
}

/// One detailed valuation returned by the custom unlevered DCF route.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[non_exhaustive]
#[serde(rename_all = "camelCase")]
pub struct CustomDcfValuation {
    pub year: FiscalYearString,
    pub symbol: Ticker,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub revenue: StatementAmount,
    pub revenue_percentage: Percentage,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub ebitda: StatementAmount,
    pub ebitda_percentage: Percentage,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub ebit: StatementAmount,
    pub ebit_percentage: Percentage,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub depreciation: StatementAmount,
    pub depreciation_percentage: Percentage,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub total_cash: StatementAmount,
    pub total_cash_percentage: Percentage,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub receivables: StatementAmount,
    pub receivables_percentage: Percentage,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub inventories: StatementAmount,
    pub inventories_percentage: Percentage,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub payable: StatementAmount,
    pub payable_percentage: Percentage,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub capital_expenditure: StatementAmount,
    pub capital_expenditure_percentage: Percentage,
    pub price: Price,
    pub beta: f64,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub diluted_shares_outstanding: Quantity,
    #[serde(rename = "costofDebt")]
    pub cost_of_debt: Percentage,
    pub tax_rate: Percentage,
    pub after_tax_cost_of_debt: Percentage,
    pub risk_free_rate: Percentage,
    pub market_risk_premium: Percentage,
    pub cost_of_equity: Percentage,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub total_debt: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub total_equity: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub total_capital: StatementAmount,
    pub debt_weighting: Percentage,
    pub equity_weighting: Percentage,
    pub wacc: Percentage,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub tax_rate_cash: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub ebiat: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub ufcf: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub sum_pv_ufcf: StatementAmount,
    pub long_term_growth_rate: Percentage,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub terminal_value: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub present_terminal_value: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub enterprise_value: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub net_debt: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub equity_value: StatementAmount,
    pub equity_value_per_share: Price,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub free_cash_flow_t1: StatementAmount,
}

/// One detailed valuation returned by the custom levered DCF route.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[non_exhaustive]
#[serde(rename_all = "camelCase")]
pub struct CustomLeveredDcfValuation {
    pub year: FiscalYearString,
    pub symbol: Ticker,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub revenue: StatementAmount,
    pub revenue_percentage: Percentage,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub capital_expenditure: StatementAmount,
    pub capital_expenditure_percentage: Percentage,
    pub price: Price,
    pub beta: f64,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub diluted_shares_outstanding: Quantity,
    #[serde(rename = "costofDebt")]
    pub cost_of_debt: Percentage,
    pub tax_rate: Percentage,
    pub after_tax_cost_of_debt: Percentage,
    pub risk_free_rate: Percentage,
    pub market_risk_premium: Percentage,
    pub cost_of_equity: Percentage,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub total_debt: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub total_equity: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub total_capital: StatementAmount,
    pub debt_weighting: Percentage,
    pub equity_weighting: Percentage,
    pub wacc: Percentage,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub operating_cash_flow: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub pv_lfcf: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub sum_pv_lfcf: StatementAmount,
    pub long_term_growth_rate: Percentage,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub free_cash_flow: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub terminal_value: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub present_terminal_value: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub enterprise_value: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub net_debt: StatementAmount,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub equity_value: StatementAmount,
    pub equity_value_per_share: Price,
    #[serde(serialize_with = "crate::codecs::integral_f64::serialize")]
    pub free_cash_flow_t1: StatementAmount,
    pub operating_cash_flow_percentage: Percentage,
}