v1.1.51

Author: tigusigalpa

CHANGELOG.md

@@ -5,6 +5,66 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased] - 2026-03-15
+
+### Added
+
+#### Market Service
+- **Spot Symbols Endpoint Update**: Updated `get_spot_symbols()` to use `/openApi/spot/v1/common/symbols` endpoint
+  - Added support for `maxMarketNotional` field (maximum notional amount for single market order)
+  - Added new symbol status value `29 = Pre-Delisted`
+  - Full status values: 0=Offline, 1=Online, 5=Pre-open, 10=Accessed, 25=Suspended, 29=Pre-Delisted, 30=Delisted
+
+- **Spot Klines v2 Endpoint**: Updated `get_spot_klines()` to use `/openApi/spot/v2/market/kline`
+  - Added optional `time_zone` parameter (0=UTC (default), 8=UTC+8)
+  - Updated max limit from 1000 to 1440 records
+
+#### Spot Account Service
+- **Internal Transfer Update**: Updated `internal_transfer()` method with new parameters
+  - Changed `wallet_type` to integer: 1=Fund Account, 2=Standard Futures, 3=Perpetual Futures, **4=Spot Account** (NEW)
+  - Added `user_account_type` parameter (1=UID, 2=Phone number, 3=Email)
+  - Added `user_account` parameter
+  - Added optional `calling_code` parameter (required when user_account_type=2)
+  - Added optional `transfer_client_id` parameter (custom ID, max 100 chars)
+  - Added optional `recv_window` parameter
+
+#### Sub-Account Service
+- **Sub-Account Internal Transfer Update**: Updated `sub_account_internal_transfer()` with new parameters
+  - Changed `wallet_type` to integer: 1=Fund Account, 2=Standard Futures, 3=Perpetual Futures, **15=Spot Account** (NEW)
+  - Added `user_account_type` parameter (1=UID, 2=Phone number, 3=Email)
+  - Added `user_account` parameter
+  - Added optional `calling_code` parameter
+  - Added optional `transfer_client_id` parameter
+  - Added optional `recv_window` parameter
+
+- **New Method**: `sub_mother_account_asset_transfer()` - Sub-Mother Account Asset Transfer Interface
+  - Flexible asset transfer between parent and sub-accounts
+  - Supports account types: 1=Funding, 2=Standard futures, 3=Perpetual U-based, 15=Spot
+  - Only available to master account
+  - Returns `tranId` (transfer record ID)
+
+- **New Method**: `get_sub_mother_account_transferable_amount()` - Query Sub-Mother Account Transferable Amount
+  - Query supported coins and available transferable amounts
+  - Only available to master account
+  - Returns coins array with id, name, and availableAmount
+
+- **New Method**: `get_sub_mother_account_transfer_history()` - Query Sub-Mother Account Transfer History
+  - Query transfer history between sub-accounts and parent account
+  - Supports filtering by type, tran_id, time range
+  - Pagination support (page_id, paging_size)
+  - Only available to master account
+
+### Changed
+- Updated BingX API integration to support changes from December 2025 through February 2026
+- Improved parameter validation and type safety across all updated methods
+
+### API Compatibility
+- Breaking changes in method signatures for `internal_transfer()` and `sub_account_internal_transfer()`
+- All new parameters are optional with sensible defaults where applicable
+- Maintains Python naming conventions (snake_case)
+
+---
+
 ## [1.0.0] - 2024-03-09
 
 ### Added

README.md

@@ -175,6 +175,12 @@ import time
 start_ts = int(time.mktime(time.strptime("2024-01-01", "%Y-%m-%d")) * 1000)
 end_ts = int(time.mktime(time.strptime("2024-01-02", "%Y-%m-%d")) * 1000)
 klines = client.market().get_klines("BTC-USDT", "1h", 100, start_ts, end_ts)
+
+# Spot klines with timezone (v2 endpoint)
+# time_zone: 0=UTC (default), 8=UTC+8
+spot_klines = client.market().get_spot_klines(
+    "BTC-USDT", "1h", 100, start_ts, end_ts, time_zone=8
+)
 ```
 
 #### Funding Rate, Mark Price
@@ -360,9 +366,18 @@ transfer = client.spot_account().universal_transfer(
 
 history = client.spot_account().get_asset_transfer_records(type_="FUND_PFUTURES")
 
+# Internal transfer (main account internal transfer)
+# wallet_type: 1=Fund Account, 2=Standard Futures, 3=Perpetual Futures, 4=Spot Account
+# user_account_type: 1=UID, 2=Phone number, 3=Email
 internal = client.spot_account().internal_transfer(
-    coin="USDT", wallet_type="SPOT", amount=50.0,
-    transfer_type="FROM_MAIN_TO_SUB", sub_uid="123456"
+    coin="USDT",
+    wallet_type=4,  # Spot Account
+    amount=50.0,
+    user_account_type=1,  # UID
+    user_account="123456",
+    calling_code=None,  # Required when user_account_type=2
+    transfer_client_id="transfer-001",  # Optional custom ID
+    recv_window=None
 )
 
 all_balances = client.spot_account().get_all_account_balances()
@@ -398,9 +413,55 @@ client.sub_account().delete_sub_account_api_key("sub_account_001", "your_api_key
 #### Transfers
 
 ```python
+# Sub-account internal transfer
+# wallet_type: 1=Fund Account, 2=Standard Futures, 3=Perpetual Futures, 15=Spot Account
+# user_account_type: 1=UID, 2=Phone number, 3=Email
 transfer = client.sub_account().sub_account_internal_transfer(
-    coin="USDT", wallet_type="SPOT", amount=100.0,
-    transfer_type="FROM_MAIN_TO_SUB", to_sub_uid="12345678"
+    coin="USDT",
+    wallet_type=15,  # Spot Account
+    amount=100.0,
+    user_account_type=1,  # UID
+    user_account="12345678",
+    calling_code=None,  # Required when user_account_type=2
+    transfer_client_id="transfer-001",  # Optional custom ID
+    recv_window=None
+)
+
+# Sub-Mother Account Asset Transfer (master account only)
+# Flexible transfer between parent and sub-accounts
+transfer = client.sub_account().sub_mother_account_asset_transfer(
+    asset_name="USDT",
+    transfer_amount=100.0,
+    from_uid=123456,
+    from_type=1,  # 1=Parent account, 2=Sub-account
+    from_account_type=1,  # 1=Funding, 2=Standard futures, 3=Perpetual, 15=Spot
+    to_uid=789012,
+    to_type=2,  # 1=Parent account, 2=Sub-account
+    to_account_type=15,  # Spot account
+    remark="Transfer to sub-account",
+    recv_window=None
+)
+
+# Query transferable amount (master account only)
+transferable = client.sub_account().get_sub_mother_account_transferable_amount(
+    from_uid=123456,
+    from_account_type=1,  # Funding
+    to_uid=789012,
+    to_account_type=15,  # Spot
+    recv_window=None
+)
+
+# Query transfer history (master account only)
+import time
+history = client.sub_account().get_sub_mother_account_transfer_history(
+    uid=123456,
+    type_=None,  # Optional filter
+    tran_id=None,  # Optional filter
+    start_time=int(time.time() - 7*24*3600) * 1000,
+    end_time=int(time.time()) * 1000,
+    page_id=1,
+    paging_size=50,
+    recv_window=None
 )
 
 records = client.sub_account().get_sub_account_internal_transfer_records()

bingx/services/market.py

@@ -26,8 +26,15 @@ def get_futures_symbols(self) -> Dict[str, Any]:
         return self.client.request("GET", "/openApi/swap/v2/market/symbols")
 
     def get_spot_symbols(self) -> Dict[str, Any]:
-        """Get spot trading symbols"""
-        return self.client.request("GET", "/openApi/spot/v1/market/symbols")
+        """
+        Get spot trading symbols
+        
+        Response includes:
+        - maxMarketNotional: Maximum notional amount for a single market order
+        - status: Symbol status (0=Offline, 1=Online, 5=Pre-open, 10=Accessed, 
+                  25=Suspended, 29=Pre-Delisted, 30=Delisted)
+        """
+        return self.client.request("GET", "/openApi/spot/v1/common/symbols")
 
     def get_all_symbols(self) -> Dict[str, Any]:
         """Get all available symbols (both spot and futures)"""
@@ -107,23 +114,27 @@ def get_spot_klines(
         limit: int = 500,
         start_time: Optional[int] = None,
         end_time: Optional[int] = None,
+        time_zone: Optional[int] = None,
     ) -> Dict[str, Any]:
         """
         Get candlestick data for spot
 
         Args:
             symbol: Trading symbol
-            interval: Kline interval (1m, 5m, 15m, 30m, 1h, 4h, 1d, etc.)
-            limit: Number of klines to return
+            interval: Kline interval (1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M)
+            limit: Number of klines to return (max 1440)
             start_time: Start time in milliseconds
             end_time: End time in milliseconds
+            time_zone: Timezone offset (0=UTC (default), 8=UTC+8)
         """
         params = {"symbol": symbol, "interval": interval, "limit": limit}
         if start_time:
             params["startTime"] = start_time
         if end_time:
             params["endTime"] = end_time
-        return self.client.request("GET", "/openApi/spot/v1/market/klines", params)
+        if time_zone is not None:
+            params["timeZone"] = time_zone
+        return self.client.request("GET", "/openApi/spot/v2/market/kline", params)
 
     def get_24hr_ticker(self, symbol: Optional[str] = None) -> Dict[str, Any]:
         """

bingx/services/spot_account.py

@@ -74,30 +74,41 @@ def get_asset_transfer_records(
     def internal_transfer(
         self,
         coin: str,
-        wallet_type: str,
+        wallet_type: int,
         amount: float,
-        transfer_type: str,
-        sub_uid: Optional[str] = None,
+        user_account_type: int,
+        user_account: str,
+        calling_code: Optional[str] = None,
+        transfer_client_id: Optional[str] = None,
+        recv_window: Optional[int] = None,
     ) -> Dict[str, Any]:
         """
-        Internal transfer (main <-> sub account)
+        Internal transfer (main account internal transfer)
 
         Args:
             coin: Coin name
-            wallet_type: Wallet type (SPOT, PERPETUAL)
+            wallet_type: Wallet type (1=Fund Account, 2=Standard Futures, 3=Perpetual Futures, 4=Spot Account)
             amount: Transfer amount
-            transfer_type: Transfer type (FROM_MAIN_TO_SUB, FROM_SUB_TO_MAIN)
-            sub_uid: Sub-account UID
+            user_account_type: User account type (1=UID, 2=Phone number, 3=Email)
+            user_account: User account (UID, phone number, or email)
+            calling_code: Area code for telephone (required when user_account_type=2)
+            transfer_client_id: Custom ID for internal transfer (alphanumeric, max 100 chars)
+            recv_window: Request validity time window in milliseconds
         """
         params = {
             "coin": coin,
             "walletType": wallet_type,
             "amount": amount,
-            "transferType": transfer_type,
+            "userAccountType": user_account_type,
+            "userAccount": user_account,
         }
-        if sub_uid:
-            params["subUid"] = sub_uid
-        return self.client.request("POST", "/openApi/api/v3/asset/internal/transfer", params)
+        if calling_code:
+            params["callingCode"] = calling_code
+        if transfer_client_id:
+            params["transferClientId"] = transfer_client_id
+        if recv_window is not None:
+            params["recvWindow"] = recv_window
+        return self.client.request("POST", "/openApi/wallets/v1/capital/innerTransfer/apply", params)
 
     def get_all_account_balances(self) -> Dict[str, Any]:
         """Get all account balances"""