akshare 0.1.0

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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

//! 柯桥时尚指数.

use serde::Deserialize;

use crate::client::AkShareClient;
use crate::error::{Error, Result};

// ---------------------------------------------------------------------------
// Public API
// ---------------------------------------------------------------------------

impl AkShareClient {
    /// 柯桥时尚指数及其子项数据.
    ///
    /// `symbol` is one of many sub-indices, e.g. "柯桥时尚指数", "时尚创意指数",
    /// "时尚设计人才数", etc.
    pub async fn index_kq_fashion(&self, symbol: &str) -> Result<Vec<KqFashionPoint>> {
        let struct_code = match symbol {
            "柯桥时尚指数" => "root",
            "时尚创意指数" => "01",
            "时尚设计人才数" => "0101",
            "新花型推出数" => "0102",
            "创意产品成交数" => "0103",
            "创意企业数量" => "0104",
            "时尚活跃度指数" => "02",
            "电商运行数" => "0201",
            "时尚平台拓展数" => "0201",
            "新产品销售额占比" => "0201",
            "企业合作占比" => "0201",
            "品牌传播费用" => "0201",
            "时尚推广度指数" => "03",
            "国际交流合作次数" => "0301",
            "企业参展次数" => "0302",
            "外商驻点数量变化" => "0302",
            "时尚评价指数" => "04",
            _ => {
                return Err(Error::invalid_input(format!(
                    "unknown KQ fashion index: {symbol}"
                )));
            }
        };

        #[derive(Deserialize)]
        struct Envelope {
            data: Option<Vec<FashionItem>>,
        }

        #[derive(Deserialize)]
        #[allow(non_snake_case)]
        struct FashionItem {
            #[serde(default)]
            publishTime: String,
            #[serde(default)]
            indexValue: Option<f64>,
        }

        let response = self
            .get("http://api.idx365.com/index/project/34/data")
            .query(&[("structCode", struct_code)])
            .send()
            .await
            .map_err(Error::from)?
            .error_for_status()
            .map_err(Error::from)?;

        let payload: Envelope = response.json().await.map_err(Error::from)?;
        let items = payload.data.unwrap_or_default();

        let mut points: Vec<KqFashionPoint> = items
            .into_iter()
            .map(|item| KqFashionPoint {
                date: item.publishTime,
                index: item.indexValue.unwrap_or(0.0),
                change_value: 0.0,
                change_pct: 0.0,
            })
            .collect();

        points.sort_by(|a, b| a.date.cmp(&b.date));

        // Compute diff and pct_change
        for i in 1..points.len() {
            let prev = points[i - 1].index;
            points[i].change_value = points[i].index - prev;
            if prev != 0.0 {
                points[i].change_pct = (points[i].index - prev) / prev;
            }
        }

        if points.is_empty() {
            return Err(Error::not_found("idx365 returned no KQ fashion data"));
        }
        Ok(points)
    }
}

/// KQ fashion index point.
#[derive(Debug, Clone, serde::Serialize, serde::Deserialize)]
pub struct KqFashionPoint {
    pub date: String,
    pub index: f64,
    pub change_value: f64,
    pub change_pct: f64,
}

#[cfg(test)]
mod tests {
    #[test]
    fn test_placeholder() {
        // KQ SS functions require network access.
    }
}