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    /// Fetch raw corporate action events used for price adjustment.
8    pub async fn corp_actions_adjustment_factors(
9        &self,
10        thscode: &AShareCode,
11        from: Option<NaturalDate>,
12        to: Option<NaturalDate>,
13    ) -> Result<Response<AdjustmentFactorsData>, Error> {
14        let mut query = vec![("thscode", thscode.to_string())];
15        if let (Some(from), Some(to)) = (from, to) {
16            validate_date_order(from, to, "to")?;
17        }
18        if let Some(from) = from {
19            query.push(("from", from.to_string()));
20        }
21        if let Some(to) = to {
22            query.push(("to", to.to_string()));
23        }
24        self.get(endpoints::ADJUSTMENT_FACTORS, &query).await
25    }
26}
27
28#[cfg(test)]
29mod tests {
30    use super::*;
31    use crate::ApiKey;
32
33    #[tokio::test]
34    async fn adjustment_factors_rejects_reversed_dates_before_transport() {
35        let client = Client::builder(ApiKey::new("test-api-key").unwrap())
36            .base_url("http://127.0.0.1:9")
37            .build()
38            .unwrap();
39        let stock = AShareCode::new("600519.SH").unwrap();
40
41        let error = client
42            .corp_actions_adjustment_factors(
43                &stock,
44                Some(NaturalDate::parse("2026-08-25").unwrap()),
45                Some(NaturalDate::parse("2026-08-24").unwrap()),
46            )
47            .await
48            .unwrap_err();
49
50        let Error::InvalidInput(error) = error else {
51            panic!("expected an invalid corporate-action date range");
52        };
53        assert_eq!(error.field(), "to");
54    }
55}