Merge pull request #61 from binance/rc-v9.0.0

Release v9.0.0

Author: dimitrisn442

CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 9.0.0 - 2025-07-22
+
+### Added (1)
+
+**Wallet**
+
+- `check_questionnaire_requirements()` (`GET /sapi/v1/localentity/questionnaire-requirements`)
+
+### Changed (4)
+
+**Derivatives Trading Options**
+
+#### REST API
+
+- Modified response for `exchange_information()` method (`GET /eapi/v1/exchangeInfo`):
+  - `optionSymbols`: item property `liquidationFeeRate` added
+
+- Modified response for `option_margin_account_information()` method (`GET /eapi/v1/marginAccount`):
+  - `asset`: item property `adjustedEquity` added
+  - `asset`: item property `lpProfit` deleted
+
+**Wallet**
+
+- Added parameter `recvWindow`
+  - affected methods:
+    - `fetch_address_verification_list()` (`GET /sapi/v1/addressVerify/list`)
+    - `vasp_list()` (`GET /sapi/v1/localentity/vasp`)
+
+**Spot**
+
+#### REST API
+
+- Added missing parameters for `order_test()` (`POST /api/v3/order/test`)
+
 ## 8.0.0 - 2025-07-14
 
 ### Added (1)

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "binance-sdk"
-version = "8.0.0"
+version = "9.0.0"
 authors = [ "Binance" ]
 edition = "2024"
 resolver = "3"
@@ -849,6 +849,11 @@ name = "derivatives_trading_options_rest_api_account_api_option_account_informat
 path = "examples/derivatives_trading_options/rest_api/account_api/option_account_information.rs"
 required-features = [ "derivatives_trading_options" ]
 
+[[example]]
+name = "derivatives_trading_options_rest_api_account_api_option_margin_account_information"
+path = "examples/derivatives_trading_options/rest_api/account_api/option_margin_account_information.rs"
+required-features = [ "derivatives_trading_options" ]
+
 [[example]]
 name = "derivatives_trading_options_rest_api_market_data_api_check_server_time"
 path = "examples/derivatives_trading_options/rest_api/market_data_api/check_server_time.rs"
@@ -964,11 +969,6 @@ name = "derivatives_trading_options_rest_api_market_maker_endpoints_api_get_mark
 path = "examples/derivatives_trading_options/rest_api/market_maker_endpoints_api/get_market_maker_protection_config.rs"
 required-features = [ "derivatives_trading_options" ]
 
-[[example]]
-name = "derivatives_trading_options_rest_api_market_maker_endpoints_api_option_margin_account_information"
-path = "examples/derivatives_trading_options/rest_api/market_maker_endpoints_api/option_margin_account_information.rs"
-required-features = [ "derivatives_trading_options" ]
-
 [[example]]
 name = "derivatives_trading_options_rest_api_market_maker_endpoints_api_reset_market_maker_protection_config"
 path = "examples/derivatives_trading_options/rest_api/market_maker_endpoints_api/reset_market_maker_protection_config.rs"
@@ -3989,14 +3989,19 @@ name = "wallet_rest_api_travel_rule_api_broker_withdraw"
 path = "examples/wallet/rest_api/travel_rule_api/broker_withdraw.rs"
 required-features = [ "wallet" ]
 
+[[example]]
+name = "wallet_rest_api_travel_rule_api_check_questionnaire_requirements"
+path = "examples/wallet/rest_api/travel_rule_api/check_questionnaire_requirements.rs"
+required-features = [ "wallet" ]
+
 [[example]]
 name = "wallet_rest_api_travel_rule_api_deposit_history_travel_rule"
 path = "examples/wallet/rest_api/travel_rule_api/deposit_history_travel_rule.rs"
 required-features = [ "wallet" ]
 
 [[example]]
-name = "wallet_rest_api_travel_rule_api_onboarded_vasp_list"
-path = "examples/wallet/rest_api/travel_rule_api/onboarded_vasp_list.rs"
+name = "wallet_rest_api_travel_rule_api_fetch_address_verification_list"
+path = "examples/wallet/rest_api/travel_rule_api/fetch_address_verification_list.rs"
 required-features = [ "wallet" ]
 
 [[example]]
@@ -4009,6 +4014,11 @@ name = "wallet_rest_api_travel_rule_api_submit_deposit_questionnaire"
 path = "examples/wallet/rest_api/travel_rule_api/submit_deposit_questionnaire.rs"
 required-features = [ "wallet" ]
 
+[[example]]
+name = "wallet_rest_api_travel_rule_api_vasp_list"
+path = "examples/wallet/rest_api/travel_rule_api/vasp_list.rs"
+required-features = [ "wallet" ]
+
 [[example]]
 name = "wallet_rest_api_travel_rule_api_withdraw_history_v1"
 path = "examples/wallet/rest_api/travel_rule_api/withdraw_history_v1.rs"

examples/derivatives_trading_options/rest_api/market_maker_endpoints_api/option_margin_account_information.rs renamed to examples/derivatives_trading_options/rest_api/account_api/option_margin_account_information.rs

@@ -3,7 +3,10 @@ use std::env;
 use tracing::info;
 
 use binance_sdk::config::ConfigurationRestApi;
-use binance_sdk::spot::{SpotRestApi, rest_api::OrderTestParams};
+use binance_sdk::spot::{
+    SpotRestApi,
+    rest_api::{OrderTestParams, OrderTestSideEnum, OrderTestTypeEnum},
+};
 
 #[tokio::main]
 async fn main() -> Result<()> {
@@ -21,7 +24,12 @@ async fn main() -> Result<()> {
     let rest_client = SpotRestApi::production(rest_conf);
 
     // Setup the API parameters
-    let params = OrderTestParams::default();
+    let params = OrderTestParams::builder(
+        "BNBUSDT".to_string(),
+        OrderTestSideEnum::Buy,
+        OrderTestTypeEnum::Market,
+    )
+    .build()?;
 
     // Make the API call
     let response = rest_client

examples/spot/rest_api/trade_api/order_test.rs

@@ -0,0 +1,37 @@
+use anyhow::{Context, Result};
+use std::env;
+use tracing::info;
+
+use binance_sdk::config::ConfigurationRestApi;
+use binance_sdk::wallet::{WalletRestApi, rest_api::CheckQuestionnaireRequirementsParams};
+
+#[tokio::main]
+async fn main() -> Result<()> {
+    // Load credentials from env
+    let api_key = env::var("API_KEY").context("API_KEY must be set")?;
+    let api_secret = env::var("API_SECRET").context("API_SECRET must be set")?;
+
+    // Build REST config
+    let rest_conf = ConfigurationRestApi::builder()
+        .api_key(api_key)
+        .api_secret(api_secret)
+        .build()?;
+
+    // Create the Wallet REST API client
+    let rest_client = WalletRestApi::production(rest_conf);
+
+    // Setup the API parameters
+    let params = CheckQuestionnaireRequirementsParams::default();
+
+    // Make the API call
+    let response = rest_client
+        .check_questionnaire_requirements(params)
+        .await
+        .context("check_questionnaire_requirements request failed")?;
+
+    info!(?response.rate_limits, "check_questionnaire_requirements rate limits");
+    let data = response.data().await?;
+    info!(?data, "check_questionnaire_requirements data");
+
+    Ok(())
+}

examples/wallet/rest_api/travel_rule_api/check_questionnaire_requirements.rs

@@ -3,7 +3,7 @@ use std::env;
 use tracing::info;
 
 use binance_sdk::config::ConfigurationRestApi;
-use binance_sdk::wallet::WalletRestApi;
+use binance_sdk::wallet::{WalletRestApi, rest_api::FetchAddressVerificationListParams};
 
 #[tokio::main]
 async fn main() -> Result<()> {
@@ -20,9 +20,12 @@ async fn main() -> Result<()> {
     // Create the Wallet REST API client
     let rest_client = WalletRestApi::production(rest_conf);
 
+    // Setup the API parameters
+    let params = FetchAddressVerificationListParams::default();
+
     // Make the API call
     let response = rest_client
-        .fetch_address_verification_list()
+        .fetch_address_verification_list(params)
         .await
         .context("fetch_address_verification_list request failed")?;
 

examples/wallet/rest_api/travel_rule_api/fetch_address_verification_list.rs

@@ -3,7 +3,7 @@ use std::env;
 use tracing::info;
 
 use binance_sdk::config::ConfigurationRestApi;
-use binance_sdk::wallet::WalletRestApi;
+use binance_sdk::wallet::{WalletRestApi, rest_api::VaspListParams};
 
 #[tokio::main]
 async fn main() -> Result<()> {
@@ -20,15 +20,18 @@ async fn main() -> Result<()> {
     // Create the Wallet REST API client
     let rest_client = WalletRestApi::production(rest_conf);
 
+    // Setup the API parameters
+    let params = VaspListParams::default();
+
     // Make the API call
     let response = rest_client
-        .onboarded_vasp_list()
+        .vasp_list(params)
         .await
-        .context("onboarded_vasp_list request failed")?;
+        .context("vasp_list request failed")?;
 
-    info!(?response.rate_limits, "onboarded_vasp_list rate limits");
+    info!(?response.rate_limits, "vasp_list rate limits");
     let data = response.data().await?;
-    info!(?data, "onboarded_vasp_list data");
+    info!(?data, "vasp_list data");
 
     Ok(())
 }

examples/wallet/rest_api/travel_rule_api/onboarded_vasp_list.rs renamed to examples/wallet/rest_api/travel_rule_api/vasp_list.rs

@@ -47,6 +47,10 @@ pub trait AccountApi: Send + Sync {
         &self,
         params: OptionAccountInformationParams,
     ) -> anyhow::Result<RestApiResponse<models::OptionAccountInformationResponse>>;
+    async fn option_margin_account_information(
+        &self,
+        params: OptionMarginAccountInformationParams,
+    ) -> anyhow::Result<RestApiResponse<models::OptionMarginAccountInformationResponse>>;
 }
 
 #[derive(Debug, Clone)]
@@ -212,6 +216,29 @@ impl OptionAccountInformationParams {
         OptionAccountInformationParamsBuilder::default()
     }
 }
+/// Request parameters for the [`option_margin_account_information`] operation.
+///
+/// This struct holds all of the inputs you can pass when calling
+/// [`option_margin_account_information`](#method.option_margin_account_information).
+#[derive(Clone, Debug, Builder, Default)]
+#[builder(pattern = "owned", build_fn(error = "ParamBuildError"))]
+pub struct OptionMarginAccountInformationParams {
+    ///
+    /// The `recv_window` parameter.
+    ///
+    /// This field is **optional.
+    #[builder(setter(into), default)]
+    pub recv_window: Option<i64>,
+}
+
+impl OptionMarginAccountInformationParams {
+    /// Create a builder for [`option_margin_account_information`].
+    ///
+    #[must_use]
+    pub fn builder() -> OptionMarginAccountInformationParamsBuilder {
+        OptionMarginAccountInformationParamsBuilder::default()
+    }
+}
 
 #[async_trait]
 impl AccountApi for AccountApiClient {
@@ -362,6 +389,33 @@ impl AccountApi for AccountApiClient {
         )
         .await
     }
+
+    async fn option_margin_account_information(
+        &self,
+        params: OptionMarginAccountInformationParams,
+    ) -> anyhow::Result<RestApiResponse<models::OptionMarginAccountInformationResponse>> {
+        let OptionMarginAccountInformationParams { recv_window } = params;
+
+        let mut query_params = BTreeMap::new();
+
+        if let Some(rw) = recv_window {
+            query_params.insert("recvWindow".to_string(), json!(rw));
+        }
+
+        send_request::<models::OptionMarginAccountInformationResponse>(
+            &self.configuration,
+            "/eapi/v1/marginAccount",
+            reqwest::Method::GET,
+            query_params,
+            if HAS_TIME_UNIT {
+                self.configuration.time_unit
+            } else {
+                None
+            },
+            true,
+        )
+        .await
+    }
 }
 
 #[cfg(all(test, feature = "derivatives_trading_options"))]
@@ -503,6 +557,32 @@ mod tests {
 
             Ok(dummy.into())
         }
+
+        async fn option_margin_account_information(
+            &self,
+            _params: OptionMarginAccountInformationParams,
+        ) -> anyhow::Result<RestApiResponse<models::OptionMarginAccountInformationResponse>>
+        {
+            if self.force_error {
+                return Err(
+                    ConnectorError::ConnectorClientError("ResponseError".to_string()).into(),
+                );
+            }
+
+            let resp_json: Value = serde_json::from_str(r#"{"asset":[{"asset":"USDT","marginBalance":"10099.448","equity":"10094.44662","available":"8725.92524","initialMargin":"1084.52138","maintMargin":"151.00138","unrealizedPNL":"-5.00138","adjustedEquity":"34.13282285"}],"greek":[{"underlying":"BTCUSDT","delta":"-0.05","gamma":"-0.002","theta":"-0.05","vega":"-0.002"}],"time":1592449455993}"#).unwrap();
+            let dummy_response: models::OptionMarginAccountInformationResponse =
+                serde_json::from_value(resp_json.clone())
+                    .expect("should parse into models::OptionMarginAccountInformationResponse");
+
+            let dummy = DummyRestApiResponse {
+                inner: Box::new(move || Box::pin(async move { Ok(dummy_response) })),
+                status: 200,
+                headers: HashMap::new(),
+                rate_limits: None,
+            };
+
+            Ok(dummy.into())
+        }
     }
 
     #[test]
@@ -749,4 +829,56 @@ mod tests {
             }
         });
     }
+
+    #[test]
+    fn option_margin_account_information_required_params_success() {
+        TOKIO_SHARED_RT.block_on(async {
+            let client = MockAccountApiClient { force_error: false };
+
+            let params = OptionMarginAccountInformationParams::builder().build().unwrap();
+
+            let resp_json: Value = serde_json::from_str(r#"{"asset":[{"asset":"USDT","marginBalance":"10099.448","equity":"10094.44662","available":"8725.92524","initialMargin":"1084.52138","maintMargin":"151.00138","unrealizedPNL":"-5.00138","adjustedEquity":"34.13282285"}],"greek":[{"underlying":"BTCUSDT","delta":"-0.05","gamma":"-0.002","theta":"-0.05","vega":"-0.002"}],"time":1592449455993}"#).unwrap();
+            let expected_response : models::OptionMarginAccountInformationResponse = serde_json::from_value(resp_json.clone()).expect("should parse into models::OptionMarginAccountInformationResponse");
+
+            let resp = client.option_margin_account_information(params).await.expect("Expected a response");
+            let data_future = resp.data();
+            let actual_response = data_future.await.unwrap();
+            assert_eq!(actual_response, expected_response);
+        });
+    }
+
+    #[test]
+    fn option_margin_account_information_optional_params_success() {
+        TOKIO_SHARED_RT.block_on(async {
+            let client = MockAccountApiClient { force_error: false };
+
+            let params = OptionMarginAccountInformationParams::builder().recv_window(5000).build().unwrap();
+
+            let resp_json: Value = serde_json::from_str(r#"{"asset":[{"asset":"USDT","marginBalance":"10099.448","equity":"10094.44662","available":"8725.92524","initialMargin":"1084.52138","maintMargin":"151.00138","unrealizedPNL":"-5.00138","adjustedEquity":"34.13282285"}],"greek":[{"underlying":"BTCUSDT","delta":"-0.05","gamma":"-0.002","theta":"-0.05","vega":"-0.002"}],"time":1592449455993}"#).unwrap();
+            let expected_response : models::OptionMarginAccountInformationResponse = serde_json::from_value(resp_json.clone()).expect("should parse into models::OptionMarginAccountInformationResponse");
+
+            let resp = client.option_margin_account_information(params).await.expect("Expected a response");
+            let data_future = resp.data();
+            let actual_response = data_future.await.unwrap();
+            assert_eq!(actual_response, expected_response);
+        });
+    }
+
+    #[test]
+    fn option_margin_account_information_response_error() {
+        TOKIO_SHARED_RT.block_on(async {
+            let client = MockAccountApiClient { force_error: true };
+
+            let params = OptionMarginAccountInformationParams::builder()
+                .build()
+                .unwrap();
+
+            match client.option_margin_account_information(params).await {
+                Ok(_) => panic!("Expected an error"),
+                Err(err) => {
+                    assert_eq!(err.to_string(), "Connector client error: ResponseError");
+                }
+            }
+        });
+    }
 }