Skip to main content

binance_sdk/convert/rest_api/apis/
market_data_api.rs

1/*
2 * Convert REST API
3 *
4 * Request quotes and execute cryptocurrency conversions via the Convert REST API.
5 *
6 * The version of the OpenAPI document: 1.0.0
7 *
8 *
9 * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
10 * https://openapi-generator.tech
11 * Do not edit the class manually.
12 */
13
14#![allow(unused_imports)]
15use async_trait::async_trait;
16use derive_builder::Builder;
17use reqwest;
18use rust_decimal::prelude::*;
19use serde::{Deserialize, Serialize};
20use serde_json::{Value, json};
21use std::collections::BTreeMap;
22
23use crate::common::{
24    config::ConfigurationRestApi,
25    models::{ParamBuildError, RestApiResponse},
26    utils::send_request,
27};
28use crate::convert::rest_api::models;
29
30const HAS_TIME_UNIT: bool = false;
31
32#[async_trait]
33pub trait MarketDataApi: Send + Sync {
34    async fn list_all_convert_pairs(
35        &self,
36        params: ListAllConvertPairsParams,
37    ) -> anyhow::Result<RestApiResponse<Vec<models::ListAllConvertPairsResponseInner>>>;
38    async fn query_order_quantity_precision_per_asset(
39        &self,
40        params: QueryOrderQuantityPrecisionPerAssetParams,
41    ) -> anyhow::Result<
42        RestApiResponse<Vec<models::QueryOrderQuantityPrecisionPerAssetResponseInner>>,
43    >;
44}
45
46#[derive(Debug, Clone)]
47pub struct MarketDataApiClient {
48    configuration: ConfigurationRestApi,
49}
50
51impl MarketDataApiClient {
52    pub fn new(configuration: ConfigurationRestApi) -> Self {
53        Self { configuration }
54    }
55}
56
57/// Request parameters for the [`list_all_convert_pairs`] operation.
58///
59/// This struct holds all of the inputs you can pass when calling
60/// [`list_all_convert_pairs`](#method.list_all_convert_pairs).
61#[derive(Clone, Debug, Builder, Deserialize, Default)]
62#[builder(pattern = "owned", build_fn(error = "ParamBuildError"))]
63pub struct ListAllConvertPairsParams {
64    /// User spends coin
65    ///
66    /// This field is **optional.
67    #[builder(setter(into), default)]
68    #[serde(rename = "fromAsset", default)]
69    pub from_asset: Option<String>,
70    /// User receives coin
71    ///
72    /// This field is **optional.
73    #[builder(setter(into), default)]
74    #[serde(rename = "toAsset", default)]
75    pub to_asset: Option<String>,
76}
77
78impl ListAllConvertPairsParams {
79    /// Create a builder for [`list_all_convert_pairs`].
80    ///
81    #[must_use]
82    pub fn builder() -> ListAllConvertPairsParamsBuilder {
83        ListAllConvertPairsParamsBuilder::default()
84    }
85}
86/// Request parameters for the [`query_order_quantity_precision_per_asset`] operation.
87///
88/// This struct holds all of the inputs you can pass when calling
89/// [`query_order_quantity_precision_per_asset`](#method.query_order_quantity_precision_per_asset).
90#[derive(Clone, Debug, Builder, Deserialize, Default)]
91#[builder(pattern = "owned", build_fn(error = "ParamBuildError"))]
92pub struct QueryOrderQuantityPrecisionPerAssetParams {
93    /// Request validity window in milliseconds
94    ///
95    /// This field is **optional.
96    #[builder(setter(into), default)]
97    #[serde(rename = "recvWindow", default)]
98    pub recv_window: Option<i64>,
99}
100
101impl QueryOrderQuantityPrecisionPerAssetParams {
102    /// Create a builder for [`query_order_quantity_precision_per_asset`].
103    ///
104    #[must_use]
105    pub fn builder() -> QueryOrderQuantityPrecisionPerAssetParamsBuilder {
106        QueryOrderQuantityPrecisionPerAssetParamsBuilder::default()
107    }
108}
109
110#[async_trait]
111impl MarketDataApi for MarketDataApiClient {
112    async fn list_all_convert_pairs(
113        &self,
114        params: ListAllConvertPairsParams,
115    ) -> anyhow::Result<RestApiResponse<Vec<models::ListAllConvertPairsResponseInner>>> {
116        let ListAllConvertPairsParams {
117            from_asset,
118            to_asset,
119        } = params;
120
121        let mut query_params = BTreeMap::new();
122        let body_params = BTreeMap::new();
123
124        if let Some(rw) = from_asset {
125            query_params.insert("fromAsset".to_string(), json!(rw));
126        }
127
128        if let Some(rw) = to_asset {
129            query_params.insert("toAsset".to_string(), json!(rw));
130        }
131
132        send_request::<Vec<models::ListAllConvertPairsResponseInner>>(
133            &self.configuration,
134            "/sapi/v1/convert/exchangeInfo",
135            reqwest::Method::GET,
136            query_params,
137            body_params,
138            if HAS_TIME_UNIT {
139                self.configuration.time_unit
140            } else {
141                None
142            },
143            false,
144        )
145        .await
146    }
147
148    async fn query_order_quantity_precision_per_asset(
149        &self,
150        params: QueryOrderQuantityPrecisionPerAssetParams,
151    ) -> anyhow::Result<
152        RestApiResponse<Vec<models::QueryOrderQuantityPrecisionPerAssetResponseInner>>,
153    > {
154        let QueryOrderQuantityPrecisionPerAssetParams { recv_window } = params;
155
156        let mut query_params = BTreeMap::new();
157        let body_params = BTreeMap::new();
158
159        if let Some(rw) = recv_window {
160            query_params.insert("recvWindow".to_string(), json!(rw));
161        }
162
163        send_request::<Vec<models::QueryOrderQuantityPrecisionPerAssetResponseInner>>(
164            &self.configuration,
165            "/sapi/v1/convert/assetInfo",
166            reqwest::Method::GET,
167            query_params,
168            body_params,
169            if HAS_TIME_UNIT {
170                self.configuration.time_unit
171            } else {
172                None
173            },
174            true,
175        )
176        .await
177    }
178}
179
180#[cfg(all(test, feature = "convert"))]
181mod tests {
182    use super::*;
183    use crate::TOKIO_SHARED_RT;
184    use crate::{errors::ConnectorError, models::DataFuture, models::RestApiRateLimit};
185    use async_trait::async_trait;
186    use std::collections::HashMap;
187
188    struct DummyRestApiResponse<T> {
189        inner: Box<dyn FnOnce() -> DataFuture<Result<T, ConnectorError>> + Send + Sync>,
190        status: u16,
191        headers: HashMap<String, String>,
192        rate_limits: Option<Vec<RestApiRateLimit>>,
193    }
194
195    impl<T> From<DummyRestApiResponse<T>> for RestApiResponse<T> {
196        fn from(dummy: DummyRestApiResponse<T>) -> Self {
197            Self {
198                data_fn: dummy.inner,
199                status: dummy.status,
200                headers: dummy.headers,
201                rate_limits: dummy.rate_limits,
202            }
203        }
204    }
205
206    struct MockMarketDataApiClient {
207        force_error: bool,
208    }
209
210    #[async_trait]
211    impl MarketDataApi for MockMarketDataApiClient {
212        async fn list_all_convert_pairs(
213            &self,
214            _params: ListAllConvertPairsParams,
215        ) -> anyhow::Result<RestApiResponse<Vec<models::ListAllConvertPairsResponseInner>>>
216        {
217            if self.force_error {
218                return Err(ConnectorError::ConnectorClientError {
219                    msg: "ResponseError".to_string(),
220                    code: None,
221                }
222                .into());
223            }
224
225            let resp_json: Value = serde_json::from_str(r#"[{"fromAsset":"BTC","toAsset":"USDT","fromAssetMinAmount":"0.0004","fromAssetMaxAmount":"50","toAssetMinAmount":"20","toAssetMaxAmount":"2500000"}]"#).unwrap_or_else(|_| serde_json::json!({}));
226            let dummy_response: Vec<models::ListAllConvertPairsResponseInner> =
227                serde_json::from_value(resp_json.clone())
228                    .expect("should parse into Vec<models::ListAllConvertPairsResponseInner>");
229
230            let dummy = DummyRestApiResponse {
231                inner: Box::new(move || Box::pin(async move { Ok(dummy_response) })),
232                status: 200,
233                headers: HashMap::new(),
234                rate_limits: None,
235            };
236
237            Ok(dummy.into())
238        }
239
240        async fn query_order_quantity_precision_per_asset(
241            &self,
242            _params: QueryOrderQuantityPrecisionPerAssetParams,
243        ) -> anyhow::Result<
244            RestApiResponse<Vec<models::QueryOrderQuantityPrecisionPerAssetResponseInner>>,
245        > {
246            if self.force_error {
247                return Err(ConnectorError::ConnectorClientError {
248                    msg: "ResponseError".to_string(),
249                    code: None,
250                }
251                .into());
252            }
253
254            let resp_json: Value = serde_json::from_str(r#"[{"asset":"BTC","fraction":8}]"#)
255                .unwrap_or_else(|_| serde_json::json!({}));
256            let dummy_response : Vec<models::QueryOrderQuantityPrecisionPerAssetResponseInner> = serde_json::from_value(resp_json.clone()).expect("should parse into Vec<models::QueryOrderQuantityPrecisionPerAssetResponseInner>");
257
258            let dummy = DummyRestApiResponse {
259                inner: Box::new(move || Box::pin(async move { Ok(dummy_response) })),
260                status: 200,
261                headers: HashMap::new(),
262                rate_limits: None,
263            };
264
265            Ok(dummy.into())
266        }
267    }
268
269    #[test]
270    fn list_all_convert_pairs_required_params_success() {
271        TOKIO_SHARED_RT.block_on(async {
272            let client = MockMarketDataApiClient { force_error: false };
273
274            let params = ListAllConvertPairsParams::builder().build().unwrap();
275
276            let resp_json: Value = serde_json::from_str(r#"[{"fromAsset":"BTC","toAsset":"USDT","fromAssetMinAmount":"0.0004","fromAssetMaxAmount":"50","toAssetMinAmount":"20","toAssetMaxAmount":"2500000"}]"#).unwrap_or_else(|_| serde_json::json!({}));
277            let expected_response : Vec<models::ListAllConvertPairsResponseInner> = serde_json::from_value(resp_json.clone()).expect("should parse into Vec<models::ListAllConvertPairsResponseInner>");
278
279            let resp = client.list_all_convert_pairs(params).await.expect("Expected a response");
280            let data_future = resp.data();
281            let actual_response = data_future.await.unwrap();
282            assert_eq!(actual_response, expected_response);
283        });
284    }
285
286    #[test]
287    fn list_all_convert_pairs_optional_params_success() {
288        TOKIO_SHARED_RT.block_on(async {
289            let client = MockMarketDataApiClient { force_error: false };
290
291            let params = ListAllConvertPairsParams::builder().from_asset("BTC".to_string()).to_asset("USDT".to_string()).build().unwrap();
292
293            let resp_json: Value = serde_json::from_str(r#"[{"fromAsset":"BTC","toAsset":"USDT","fromAssetMinAmount":"0.0004","fromAssetMaxAmount":"50","toAssetMinAmount":"20","toAssetMaxAmount":"2500000"}]"#).unwrap_or_else(|_| serde_json::json!({}));
294            let expected_response : Vec<models::ListAllConvertPairsResponseInner> = serde_json::from_value(resp_json.clone()).expect("should parse into Vec<models::ListAllConvertPairsResponseInner>");
295
296            let resp = client.list_all_convert_pairs(params).await.expect("Expected a response");
297            let data_future = resp.data();
298            let actual_response = data_future.await.unwrap();
299            assert_eq!(actual_response, expected_response);
300        });
301    }
302
303    #[test]
304    fn list_all_convert_pairs_response_error() {
305        TOKIO_SHARED_RT.block_on(async {
306            let client = MockMarketDataApiClient { force_error: true };
307
308            let params = ListAllConvertPairsParams::builder().build().unwrap();
309
310            match client.list_all_convert_pairs(params).await {
311                Ok(_) => panic!("Expected an error"),
312                Err(err) => {
313                    assert_eq!(err.to_string(), "Connector client error: ResponseError");
314                }
315            }
316        });
317    }
318
319    #[test]
320    fn query_order_quantity_precision_per_asset_required_params_success() {
321        TOKIO_SHARED_RT.block_on(async {
322            let client = MockMarketDataApiClient { force_error: false };
323
324            let params = QueryOrderQuantityPrecisionPerAssetParams::builder().build().unwrap();
325
326            let resp_json: Value = serde_json::from_str(r#"[{"asset":"BTC","fraction":8}]"#).unwrap_or_else(|_| serde_json::json!({}));
327            let expected_response : Vec<models::QueryOrderQuantityPrecisionPerAssetResponseInner> = serde_json::from_value(resp_json.clone()).expect("should parse into Vec<models::QueryOrderQuantityPrecisionPerAssetResponseInner>");
328
329            let resp = client.query_order_quantity_precision_per_asset(params).await.expect("Expected a response");
330            let data_future = resp.data();
331            let actual_response = data_future.await.unwrap();
332            assert_eq!(actual_response, expected_response);
333        });
334    }
335
336    #[test]
337    fn query_order_quantity_precision_per_asset_optional_params_success() {
338        TOKIO_SHARED_RT.block_on(async {
339            let client = MockMarketDataApiClient { force_error: false };
340
341            let params = QueryOrderQuantityPrecisionPerAssetParams::builder().recv_window(5000).build().unwrap();
342
343            let resp_json: Value = serde_json::from_str(r#"[{"asset":"BTC","fraction":8}]"#).unwrap_or_else(|_| serde_json::json!({}));
344            let expected_response : Vec<models::QueryOrderQuantityPrecisionPerAssetResponseInner> = serde_json::from_value(resp_json.clone()).expect("should parse into Vec<models::QueryOrderQuantityPrecisionPerAssetResponseInner>");
345
346            let resp = client.query_order_quantity_precision_per_asset(params).await.expect("Expected a response");
347            let data_future = resp.data();
348            let actual_response = data_future.await.unwrap();
349            assert_eq!(actual_response, expected_response);
350        });
351    }
352
353    #[test]
354    fn query_order_quantity_precision_per_asset_response_error() {
355        TOKIO_SHARED_RT.block_on(async {
356            let client = MockMarketDataApiClient { force_error: true };
357
358            let params = QueryOrderQuantityPrecisionPerAssetParams::builder()
359                .build()
360                .unwrap();
361
362            match client
363                .query_order_quantity_precision_per_asset(params)
364                .await
365            {
366                Ok(_) => panic!("Expected an error"),
367                Err(err) => {
368                    assert_eq!(err.to_string(), "Connector client error: ResponseError");
369                }
370            }
371        });
372    }
373}