adaq-data-stock-us 0.1.3

Rust reimplementation of yfinance for US equity market data from Yahoo Finance.
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

//! `Sustainability` / ESG scores and analyst price targets.

use serde::{Deserialize, Serialize};
use serde_json::Value;

use crate::http::YfSession;
use crate::json::{get, get_f64};
use crate::quote::quote_summary;

/// Sustainability / ESG scores (mirrors yfinance's `sustainability`).
#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct Sustainability {
    pub esg_score: Option<f64>,
    pub environment_score: Option<f64>,
    pub social_score: Option<f64>,
    pub governance_score: Option<f64>,
    pub total_esg: Option<f64>,
    pub percentile: Option<f64>,
    pub raw: Value,
}

/// Analyst price targets (mirrors yfinance's `analyst_price_targets`).
#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct AnalystPriceTargets {
    pub current: Option<f64>,
    pub low: Option<f64>,
    pub high: Option<f64>,
    pub mean: Option<f64>,
    pub median: Option<f64>,
    pub num_analysts: Option<f64>,
}

impl YfSession {
    /// Sustainability / ESG.
    pub async fn sustainability(&self, ticker: &str) -> crate::error::Result<Sustainability> {
        let result = quote_summary(self, ticker, &["esgScores"]).await?;
        let esg = get(&result, &["esgScores"]).unwrap_or(&Value::Null);
        let f = |p: &[&str]| get_f64(esg, p);
        Ok(Sustainability {
            esg_score: f(&["esgScore"]),
            environment_score: f(&["environmentScore"]),
            social_score: f(&["socialScore"]),
            governance_score: f(&["governanceScore"]),
            total_esg: f(&["totalEsg"]),
            percentile: f(&["percentile"]),
            raw: esg.clone(),
        })
    }

    /// Analyst price targets.
    pub async fn analyst_price_targets(
        &self,
        ticker: &str,
    ) -> crate::error::Result<AnalystPriceTargets> {
        let result = quote_summary(self, ticker, &["financialData", "price"]).await?;
        let fd = get(&result, &["financialData"]).unwrap_or(&Value::Null);
        let f = |p: &[&str]| get_f64(fd, p);
        Ok(AnalystPriceTargets {
            current: f(&["currentPrice", "raw"]),
            low: f(&["targetLowPrice", "raw"]),
            high: f(&["targetHighPrice", "raw"]),
            mean: f(&["targetMeanPrice", "raw"]),
            median: f(&["targetMedianPrice", "raw"]),
            num_analysts: f(&["numberOfAnalystOpinions", "raw"]),
        })
    }
}