Skip to main content

financial_api/a_share/
corporate_actions.rs

1use crate::endpoints;
2use crate::{AShareCode, AdjustmentFactorsData, Client, Error, NaturalDate, Response};
3
4use super::validate_date_order;
5
6impl Client {
7    /// 获取原始复权事件。
8    ///
9    /// # 示例
10    #[doc = concat!(
11        "```no_run\n",
12        include_str!("../../examples/corp_actions_adjustment_factors.rs"),
13        "\n```"
14    )]
15    pub async fn corp_actions_adjustment_factors(
16        &self,
17        thscode: impl AsRef<str> + Send,
18        from: Option<&str>,
19        to: Option<&str>,
20    ) -> Result<Response<AdjustmentFactorsData>, Error> {
21        let thscode = AShareCode::new(thscode)?;
22        let from = from.map(NaturalDate::parse).transpose()?;
23        let to = to.map(NaturalDate::parse).transpose()?;
24        let mut query = vec![("thscode", thscode.into_string())];
25        if let (Some(from), Some(to)) = (from, to) {
26            validate_date_order(from, to, "to")?;
27        }
28        if let Some(from) = from {
29            query.push(("from", from.to_string()));
30        }
31        if let Some(to) = to {
32            query.push(("to", to.to_string()));
33        }
34        self.get(endpoints::ADJUSTMENT_FACTORS, &query).await
35    }
36}
37
38#[cfg(test)]
39mod tests {
40    use super::*;
41    use crate::ApiKey;
42
43    #[tokio::test]
44    async fn adjustment_factors_rejects_reversed_dates_before_transport() {
45        let client = Client::builder(ApiKey::new("test-api-key").unwrap())
46            .base_url("http://127.0.0.1:9")
47            .build()
48            .unwrap();
49        let stock = AShareCode::new("600519.SH").unwrap();
50
51        let error = client
52            .corp_actions_adjustment_factors(&stock, Some("2026-08-25"), Some("2026-08-24"))
53            .await
54            .unwrap_err();
55
56        let Error::InvalidInput(error) = error else {
57            panic!("expected an invalid corporate-action date range");
58        };
59        assert_eq!(error.field(), "to");
60    }
61}