finance-query 2.5.1

A Rust library for querying financial data
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

//! Recommendation Trend Module
//!
//! Contains analyst recommendation trends over time.

use serde::{Deserialize, Serialize};

/// Analyst recommendation trends
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct RecommendationTrend {
    /// List of recommendation trends by period
    #[serde(default)]
    pub trend: Vec<RecommendationPeriod>,

    /// Maximum age of this data in seconds
    #[serde(default)]
    pub max_age: Option<i64>,
}

/// Recommendations for a specific time period
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct RecommendationPeriod {
    /// Time period (e.g., "0m", "-1m", "-2m")
    #[serde(default)]
    pub period: Option<String>,

    /// Number of strong buy recommendations
    #[serde(default)]
    pub strong_buy: Option<i32>,

    /// Number of buy recommendations
    #[serde(default)]
    pub buy: Option<i32>,

    /// Number of hold recommendations
    #[serde(default)]
    pub hold: Option<i32>,

    /// Number of sell recommendations
    #[serde(default)]
    pub sell: Option<i32>,

    /// Number of strong sell recommendations
    #[serde(default)]
    pub strong_sell: Option<i32>,
}

impl RecommendationPeriod {
    /// Calculate total number of analyst recommendations
    pub fn total(&self) -> i32 {
        self.strong_buy.unwrap_or(0)
            + self.buy.unwrap_or(0)
            + self.hold.unwrap_or(0)
            + self.sell.unwrap_or(0)
            + self.strong_sell.unwrap_or(0)
    }

    /// Calculate average recommendation score (1.0 = strong buy, 5.0 = strong sell)
    pub fn average_score(&self) -> Option<f64> {
        let total = self.total();
        if total == 0 {
            return None;
        }

        let score = (self.strong_buy.unwrap_or(0) as f64 * 1.0)
            + (self.buy.unwrap_or(0) as f64 * 2.0)
            + (self.hold.unwrap_or(0) as f64 * 3.0)
            + (self.sell.unwrap_or(0) as f64 * 4.0)
            + (self.strong_sell.unwrap_or(0) as f64 * 5.0);

        Some(score / total as f64)
    }
}