libfmp 1.0.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

//! Historical and trailing-twelve-month income-statement endpoints.

use crate::{Client, Result, endpoints::EndpointSpec, responses::statements::IncomeStatement};

use super::{IncomeStatementQuery, IncomeStatementTtmQuery, WORLDWIDE_STATEMENT_METADATA};

/// Describes `GET income-statement` without binding it to a transport.
pub fn income_statement(
    query: IncomeStatementQuery,
) -> EndpointSpec<IncomeStatementQuery, Vec<IncomeStatement>> {
    EndpointSpec::get("income-statement", "income-statement", query)
        .with_metadata(WORLDWIDE_STATEMENT_METADATA)
}

/// Describes `GET income-statement-ttm` without binding it to a transport.
pub fn income_statement_ttm(
    query: IncomeStatementTtmQuery,
) -> EndpointSpec<IncomeStatementTtmQuery, Vec<IncomeStatement>> {
    EndpointSpec::get("income-statement-ttm", "income-statement-ttm", query)
        .with_metadata(WORLDWIDE_STATEMENT_METADATA)
}

impl Client {
    /// Retrieves historical worldwide income statements for one company.
    pub async fn income_statement(
        &self,
        query: impl Into<IncomeStatementQuery>,
    ) -> Result<Vec<IncomeStatement>> {
        self.execute(&income_statement(query.into())).await
    }

    /// Retrieves trailing-twelve-month worldwide income statements for one company.
    pub async fn income_statement_ttm(
        &self,
        query: impl Into<IncomeStatementTtmQuery>,
    ) -> Result<Vec<IncomeStatement>> {
        self.execute(&income_statement_ttm(query.into())).await
    }
}