Skip to main content

financial_api/a_share/
auction.rs

1use crate::endpoints;
2use crate::endpoints::join_a_share_codes;
3use crate::{
4    AShareCode, AuctionBenchmarkData, AuctionSnapshotData, AuctionStage, Client, Error,
5    NaturalDate, OptionalInput, Response, ValidationError,
6};
7
8impl Client {
9    /// 获取一个或多个 A 股标的的集合竞价快照。
10    ///
11    /// # 示例
12    #[doc = concat!(
13        "```no_run\n",
14        include_str!("../../examples/a_share_auction_snapshot.rs"),
15        "\n```"
16    )]
17    pub async fn a_share_auction_snapshot(
18        &self,
19        thscodes: impl IntoIterator<Item = impl TryInto<AShareCode, Error: Into<ValidationError>>>,
20        stage: AuctionStage,
21    ) -> Result<Response<AuctionSnapshotData>, Error> {
22        let query = [
23            ("thscodes", join_a_share_codes(thscodes, None)?),
24            ("stage", stage.to_string()),
25        ];
26        self.get(endpoints::AUCTION_SNAPSHOT, &query).await
27    }
28
29    /// 获取集合竞价短线基准,可指定自然日。
30    ///
31    /// # 示例
32    #[doc = concat!(
33        "```no_run\n",
34        include_str!("../../examples/a_share_auction_short_term_benchmark.rs"),
35        "\n```"
36    )]
37    pub async fn a_share_auction_short_term_benchmark(
38        &self,
39        date: impl TryInto<OptionalInput<NaturalDate>, Error: Into<ValidationError>>,
40    ) -> Result<Response<AuctionBenchmarkData>, Error> {
41        let date: OptionalInput<NaturalDate> = date.try_into().map_err(Into::into)?;
42        let query = date
43            .into_inner()
44            .map(|date| vec![("date", date.to_string())])
45            .unwrap_or_default();
46        self.get(endpoints::AUCTION_BENCHMARK, &query).await
47    }
48}
49
50#[cfg(test)]
51mod tests {
52    use super::*;
53    use crate::ApiKey;
54
55    #[tokio::test]
56    async fn snapshot_requires_at_least_one_target_before_transport() {
57        let client = Client::builder(ApiKey::new("test-api-key").unwrap())
58            .base_url("http://127.0.0.1:9")
59            .build()
60            .unwrap();
61
62        let error = client
63            .a_share_auction_snapshot([] as [&str; 0], AuctionStage::Final)
64            .await
65            .unwrap_err();
66
67        assert!(matches!(error, Error::InvalidInput(_)));
68    }
69}