financial-api 0.2.0

Rust client for the official Tonghuashun Financial Data REST API
Documentation
use crate::endpoints;
use crate::{AShareCode, AdjustmentFactorsData, Client, Error, NaturalDate, Response};

use super::validate_date_order;

impl Client {
    /// Fetch raw corporate action events used for price adjustment.
    pub async fn corp_actions_adjustment_factors(
        &self,
        thscode: &AShareCode,
        from: Option<NaturalDate>,
        to: Option<NaturalDate>,
    ) -> Result<Response<AdjustmentFactorsData>, Error> {
        let mut query = vec![("thscode", thscode.to_string())];
        if let (Some(from), Some(to)) = (from, to) {
            validate_date_order(from, to, "to")?;
        }
        if let Some(from) = from {
            query.push(("from", from.to_string()));
        }
        if let Some(to) = to {
            query.push(("to", to.to_string()));
        }
        self.get(endpoints::ADJUSTMENT_FACTORS, &query).await
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::ApiKey;

    #[tokio::test]
    async fn adjustment_factors_rejects_reversed_dates_before_transport() {
        let client = Client::builder(ApiKey::new("test-api-key").unwrap())
            .base_url("http://127.0.0.1:9")
            .build()
            .unwrap();
        let stock = AShareCode::new("600519.SH").unwrap();

        let error = client
            .corp_actions_adjustment_factors(
                &stock,
                Some(NaturalDate::parse("2026-08-25").unwrap()),
                Some(NaturalDate::parse("2026-08-24").unwrap()),
            )
            .await
            .unwrap_err();

        let Error::InvalidInput(error) = error else {
            panic!("expected an invalid corporate-action date range");
        };
        assert_eq!(error.field(), "to");
    }
}