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

//! Fund dividend and split data from Eastmoney.

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

impl AkShareClient {
    /// Fetch fund dividend data (Python: fund_fh_em).
    ///
    /// `year`: query year (e.g. "2025").
    pub async fn fund_fh_em(&self, year: &str) -> Result<Vec<FundDividendItem>> {
        let response = self
            .get("https://fund.eastmoney.com/Data/funddataIndex_Interface.aspx")
            .query(&[
                ("dt", "8"),
                ("page", "1"),
                ("rank", "BZDM"),
                ("sort", "asc"),
                ("gs", ""),
                ("ftype", ""),
                ("year", year),
            ])
            .send()
            .await
            .map_err(Error::from)?
            .error_for_status()
            .map_err(Error::from)?;

        let text = response.text().await.map_err(Error::from)?;
        let start = text.find("[[").unwrap_or(0);
        let end_marker = text.find(";var jjfh_jjgs").unwrap_or(text.len());
        if start >= end_marker {
            return Ok(Vec::new());
        }
        let json_str = &text[start..end_marker];

        let data: Vec<Vec<serde_json::Value>> = serde_json::from_str(json_str)
            .map_err(|e| Error::decode(format!("fund dividend JSON parse: {e}")))?;

        let mut result = Vec::new();
        for (i, row) in data.iter().enumerate() {
            if row.len() < 7 {
                continue;
            }
            result.push(FundDividendItem {
                rank: (i + 1) as i32,
                fund_code: row[0].as_str().unwrap_or("").to_string(),
                fund_name: row[1].as_str().unwrap_or("").to_string(),
                record_date: row[2].as_str().unwrap_or("").to_string(),
                ex_date: row[3].as_str().unwrap_or("").to_string(),
                dividend: row[4].as_str().unwrap_or("0").parse().unwrap_or(0.0),
                pay_date: row[5].as_str().unwrap_or("").to_string(),
            });
        }
        Ok(result)
    }

    /// Fetch fund dividend ranking (Python: fund_fh_rank_em).
    pub async fn fund_fh_rank_em(&self) -> Result<Vec<FundDividendRankItem>> {
        let response = self
            .get("https://fund.eastmoney.com/Data/funddataIndex_Interface.aspx")
            .query(&[
                ("dt", "10"),
                ("page", "1"),
                ("rank", "FHFCZ"),
                ("sort", "desc"),
                ("gs", ""),
                ("ftype", ""),
            ])
            .send()
            .await
            .map_err(Error::from)?
            .error_for_status()
            .map_err(Error::from)?;

        let text = response.text().await.map_err(Error::from)?;
        let start = text.find("[[").unwrap_or(0);
        let end_marker = text.find(";var fhph_jjgs").unwrap_or(text.len());
        if start >= end_marker {
            return Ok(Vec::new());
        }
        let json_str = &text[start..end_marker];

        let data: Vec<Vec<serde_json::Value>> = serde_json::from_str(json_str)
            .map_err(|e| Error::decode(format!("fund dividend rank JSON parse: {e}")))?;

        let mut result = Vec::new();
        for (i, row) in data.iter().enumerate() {
            if row.len() < 6 {
                continue;
            }
            result.push(FundDividendRankItem {
                rank: (i + 1) as i32,
                fund_code: row[0].as_str().unwrap_or("").to_string(),
                fund_name: row[1].as_str().unwrap_or("").to_string(),
                cumulative_dividend: row[2].as_str().unwrap_or("0").parse().unwrap_or(0.0),
                cumulative_count: row[3].as_str().unwrap_or("0").parse().unwrap_or(0),
                found_date: row[4].as_str().unwrap_or("").to_string(),
            });
        }
        Ok(result)
    }
}