akshare 0.1.1

100% pure Rust implementation of akshare — unified access to Chinese and global financial market data APIs
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

//! Forex rates from Bank of China (BOC).

use serde::Deserialize;

use crate::client::AkShareClient;
use crate::error::Result;
use crate::types::ForexRate;

#[derive(Debug, Deserialize)]
struct EmDatacenterResp {
    result: Option<EmResult>,
}

#[derive(Debug, Deserialize)]
struct EmResult {
    #[serde(default)]
    data: Vec<serde_json::Value>,
}

impl AkShareClient {
    /// Fetch forex rates from Bank of China via Eastmoney datacenter.
    ///
    /// Returns the latest BOC forex rates for major currency pairs against CNY.
    pub async fn forex_boc_rates(&self) -> Result<Vec<ForexRate>> {
        let url = "https://datacenter-web.eastmoney.com/api/data/v1/get";
        let resp: EmDatacenterResp = self
            .get(url)
            .query(&[
                ("reportName", "RPT_FE_QUOTATION_BOCCN"),
                ("columns", "ALL"),
                ("pageNumber", "1"),
                ("pageSize", "50"),
                ("sortTypes", "-1"),
                ("sortColumns", "DATE"),
                ("source", "WEB"),
                ("client", "WEB"),
            ])
            .send()
            .await?
            .json()
            .await?;

        let data = resp.result.map(|r| r.data).unwrap_or_default();
        let mut items = Vec::with_capacity(data.len());
        for v in &data {
            let currency_pair = v
                .get("CURRENCY_NAME")
                .or_else(|| v.get("CURRENCY_CODE"))
                .and_then(|x| x.as_str())
                .unwrap_or("")
                .to_string();
            if currency_pair.is_empty() {
                continue;
            }

            let buy_rate = v
                .get("BUYING_RATE")
                .or_else(|| v.get("BUY_RATE"))
                .and_then(serde_json::Value::as_f64)
                .unwrap_or(0.0);
            let sell_rate = v
                .get("SELLING_RATE")
                .or_else(|| v.get("SELL_RATE"))
                .and_then(serde_json::Value::as_f64)
                .unwrap_or(0.0);
            let middle_rate = v
                .get("MIDDLE_RATE")
                .or_else(|| v.get("CENTRAL_RATE"))
                .and_then(serde_json::Value::as_f64)
                .unwrap_or(0.0);
            let date = v
                .get("DATE")
                .or_else(|| v.get("REPORT_DATE"))
                .and_then(|x| x.as_str())
                .unwrap_or("")
                .to_string();

            items.push(ForexRate {
                currency_pair,
                buy_rate,
                sell_rate,
                middle_rate,
                date: date.get(..10).unwrap_or(&date).to_string(),
                change_pct: None,
            });
        }
        Ok(items)
    }
}