Skip to main content

financial_api/a_share/
auction.rs

1use crate::endpoints;
2use crate::endpoints::join_values;
3use crate::{
4    AShareCode, AuctionBenchmarkData, AuctionSnapshotData, AuctionStage, Client, Error,
5    NaturalDate, Response,
6};
7
8impl Client {
9    /// Fetch auction snapshots for one or more A-share targets.
10    pub async fn a_share_auction_snapshot(
11        &self,
12        thscodes: &[AShareCode],
13        stage: AuctionStage,
14    ) -> Result<Response<AuctionSnapshotData>, Error> {
15        let query = [
16            ("thscodes", join_values("thscodes", thscodes, None)?),
17            ("stage", stage.to_string()),
18        ];
19        self.get(endpoints::AUCTION_SNAPSHOT, &query).await
20    }
21
22    /// Fetch the short-term auction benchmark, optionally for a natural day.
23    pub async fn a_share_auction_short_term_benchmark(
24        &self,
25        date: Option<NaturalDate>,
26    ) -> Result<Response<AuctionBenchmarkData>, Error> {
27        let query = date
28            .map(|date| vec![("date", date.to_string())])
29            .unwrap_or_default();
30        self.get(endpoints::AUCTION_BENCHMARK, &query).await
31    }
32}
33
34#[cfg(test)]
35mod tests {
36    use super::*;
37    use crate::ApiKey;
38
39    #[tokio::test]
40    async fn snapshot_requires_at_least_one_target_before_transport() {
41        let client = Client::builder(ApiKey::new("test-api-key").unwrap())
42            .base_url("http://127.0.0.1:9")
43            .build()
44            .unwrap();
45
46        let error = client
47            .a_share_auction_snapshot(&[], AuctionStage::Final)
48            .await
49            .unwrap_err();
50
51        assert!(matches!(error, Error::InvalidInput(_)));
52    }
53}