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

//! Dividends (分红送配) from Eastmoney.

use super::helpers::{fmt_date, json_f64_opt, json_str, json_str_opt};
use super::types::DividendInfo;
use crate::client::AkShareClient;
use crate::error::Result;

impl AkShareClient {
    /// 分红送配
    pub async fn stock_fhps_em(&self, date: &str) -> Result<Vec<DividendInfo>> {
        let date_fmt = fmt_date(date);
        let filter = format!("(REPORT_DATE='{date_fmt}')");
        let data = self
            .dc_fetch_all(
                "RPT_SHAREBONUS_DET",
                "ALL",
                &filter,
                "PLAN_NOTICE_DATE",
                "-1",
                500,
                10,
                &[],
            )
            .await?;
        Ok(data
            .iter()
            .map(|v| DividendInfo {
                code: json_str(v, "SECURITY_CODE"),
                name: json_str(v, "SECURITY_NAME_ABBR"),
                bonus_shares_ratio: json_f64_opt(v, "BONUS_IT_RATIO"),
                transfer_ratio: json_f64_opt(v, "TRANSFER_IT_RATIO"),
                convert_ratio: json_f64_opt(v, "PRETAX_BONUS_RMB"),
                cash_dividend_ratio: json_f64_opt(v, "PRETAX_BONUS_RMB"),
                dividend_yield: json_f64_opt(v, "DIVIDEND_YIELD"),
                eps: json_f64_opt(v, "EPS"),
                bvps: json_f64_opt(v, "BPS"),
                capital_reserve_per_share: json_f64_opt(v, "CAPITAL_RESERVE_PS"),
                undistributed_profit_per_share: json_f64_opt(v, "UNDISTRIBUTED_PER_SHARE"),
                net_profit_yoy: json_f64_opt(v, "PARENT_NETPROFIT_YOY"),
                total_shares: json_f64_opt(v, "TOTAL_SHARES"),
                plan_notice_date: json_str_opt(v, "PLAN_NOTICE_DATE"),
                record_date: json_str_opt(v, "EQUITY_RECORD_DATE"),
                ex_date: json_str_opt(v, "EX_DIVIDEND_DATE"),
                plan_progress: json_str_opt(v, "IMPL_PLAN_PROFILE"),
                latest_notice_date: json_str_opt(v, "NOTICE_DATE"),
            })
            .collect())
    }

    /// 分红送配详情
    pub async fn stock_fhps_detail_em(&self, symbol: &str) -> Result<Vec<DividendInfo>> {
        let filter = format!("(SECURITY_CODE=\"{symbol}\")");
        let data = self
            .dc_fetch_all(
                "RPT_SHAREBONUS_DET",
                "ALL",
                &filter,
                "REPORT_DATE",
                "-1",
                500,
                5,
                &[],
            )
            .await?;
        Ok(data
            .iter()
            .map(|v| DividendInfo {
                code: json_str(v, "SECURITY_CODE"),
                name: json_str(v, "SECURITY_NAME_ABBR"),
                bonus_shares_ratio: json_f64_opt(v, "BONUS_IT_RATIO"),
                transfer_ratio: json_f64_opt(v, "TRANSFER_IT_RATIO"),
                convert_ratio: json_f64_opt(v, "PRETAX_BONUS_RMB"),
                cash_dividend_ratio: json_f64_opt(v, "PRETAX_BONUS_RMB"),
                dividend_yield: json_f64_opt(v, "DIVIDEND_YIELD"),
                eps: json_f64_opt(v, "EPS"),
                bvps: json_f64_opt(v, "BPS"),
                capital_reserve_per_share: json_f64_opt(v, "CAPITAL_RESERVE_PS"),
                undistributed_profit_per_share: json_f64_opt(v, "UNDISTRIBUTED_PER_SHARE"),
                net_profit_yoy: json_f64_opt(v, "PARENT_NETPROFIT_YOY"),
                total_shares: json_f64_opt(v, "TOTAL_SHARES"),
                plan_notice_date: json_str_opt(v, "PLAN_NOTICE_DATE"),
                record_date: json_str_opt(v, "EQUITY_RECORD_DATE"),
                ex_date: json_str_opt(v, "EX_DIVIDEND_DATE"),
                plan_progress: json_str_opt(v, "IMPL_PLAN_PROFILE"),
                latest_notice_date: json_str_opt(v, "NOTICE_DATE"),
            })
            .collect())
    }
}