finnhub 0.2.2

A comprehensive Rust client for the Finnhub.io financial data API with 96% endpoint coverage, flexible rate limiting, and WebSocket support
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

//! News-related data models.

use serde::{Deserialize, Serialize};

/// Market news item.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MarketNews {
    /// News category.
    pub category: String,
    /// Published datetime (UNIX timestamp).
    pub datetime: i64,
    /// News headline.
    pub headline: String,
    /// News ID.
    pub id: i64,
    /// Thumbnail image URL.
    pub image: String,
    /// Related symbol (if any).
    pub related: String,
    /// News source.
    pub source: String,
    /// News summary.
    pub summary: String,
    /// News URL.
    pub url: String,
}

/// Company news item.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CompanyNews {
    /// News category.
    pub category: String,
    /// Published datetime (UNIX timestamp).
    pub datetime: i64,
    /// News headline.
    pub headline: String,
    /// News ID.
    pub id: i64,
    /// Thumbnail image URL.
    pub image: String,
    /// Related symbol.
    pub related: String,
    /// News source.
    pub source: String,
    /// News summary.
    pub summary: String,
    /// News URL.
    pub url: String,
}

/// News sentiment data.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct NewsSentiment {
    /// Company symbol.
    pub symbol: String,
    /// Buzz metrics.
    pub buzz: NewsBuzz,
    /// Company news score.
    pub company_news_score: f64,
    /// Sector average bullishness.
    #[serde(rename = "sectorAverageBullishPercent")]
    pub sector_average_bullishness: f64,
    /// Sector average news score.
    pub sector_average_news_score: f64,
    /// Sentiment.
    pub sentiment: SentimentData,
}

/// News buzz metrics.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct NewsBuzz {
    /// Articles in the past week.
    pub articles_in_last_week: i64,
    /// Buzz score.
    pub buzz: f64,
    /// Weekly average.
    pub weekly_average: f64,
}

/// Sentiment data.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct SentimentData {
    /// Bearish percent.
    pub bearish_percent: f64,
    /// Bullish percent.
    pub bullish_percent: f64,
}

/// News category.
#[derive(Debug, Clone, Copy, Serialize, Deserialize)]
pub enum NewsCategory {
    /// General news.
    #[serde(rename = "general")]
    General,
    /// Forex news.
    #[serde(rename = "forex")]
    Forex,
    /// Crypto news.
    #[serde(rename = "crypto")]
    Crypto,
    /// Merger news.
    #[serde(rename = "merger")]
    Merger,
}

impl std::fmt::Display for NewsCategory {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            NewsCategory::General => write!(f, "general"),
            NewsCategory::Forex => write!(f, "forex"),
            NewsCategory::Crypto => write!(f, "crypto"),
            NewsCategory::Merger => write!(f, "merger"),
        }
    }
}