finance-query 3.0.0

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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

//! CoinGecko data models.
//!
//! Re-exports canonical type from `crate::models::crypto`.

use std::collections::HashMap;

use serde::Deserialize;

pub use crate::models::crypto::CoinQuote;

// ============================================================================
// Search (`/search`)
// ============================================================================

/// Raw `/search` response.
#[derive(Debug, Clone, Deserialize)]
pub(crate) struct SearchResponseDTO {
    #[serde(default)]
    pub coins: Vec<SearchCoinDTO>,
}

/// One coin match from `/search`.
#[derive(Debug, Clone, Deserialize)]
pub(crate) struct SearchCoinDTO {
    pub id: String,
    pub name: String,
    #[serde(default)]
    pub symbol: Option<String>,
    #[serde(default)]
    pub market_cap_rank: Option<u32>,
    /// Small (~25px) icon.
    #[serde(default)]
    pub thumb: Option<String>,
    /// Full-size logo.
    #[serde(default)]
    pub large: Option<String>,
}

// ============================================================================
// Trending (`/search/trending`)
// ============================================================================

/// Raw `/search/trending` response.
#[derive(Debug, Clone, Deserialize)]
pub(crate) struct TrendingResponseDTO {
    #[serde(default)]
    pub coins: Vec<TrendingCoinWrapperDTO>,
}

/// A trending entry wraps its coin data under `"item"`.
#[derive(Debug, Clone, Deserialize)]
pub(crate) struct TrendingCoinWrapperDTO {
    pub item: TrendingCoinItemDTO,
}

/// One coin's data within a trending entry.
#[derive(Debug, Clone, Deserialize)]
pub(crate) struct TrendingCoinItemDTO {
    pub id: String,
    pub name: String,
    pub symbol: String,
    pub market_cap_rank: Option<u32>,
    pub price_btc: Option<f64>,
    pub score: Option<u32>,
}

// ============================================================================
// Global (`/global`)
// ============================================================================

/// Raw `/global` response.
#[derive(Debug, Clone, Deserialize)]
pub(crate) struct GlobalResponseDTO {
    pub data: GlobalDataDTO,
}

/// The `"data"` payload of `/global`.
#[derive(Debug, Clone, Deserialize)]
pub(crate) struct GlobalDataDTO {
    pub active_cryptocurrencies: Option<u32>,
    pub markets: Option<u32>,
    #[serde(default)]
    pub total_market_cap: HashMap<String, f64>,
    #[serde(default)]
    pub total_volume: HashMap<String, f64>,
    #[serde(default)]
    pub market_cap_percentage: HashMap<String, f64>,
    pub market_cap_change_percentage_24h_usd: Option<f64>,
}