Merge pull request #326 from binance/rc-v3.8.0

Release v3.8.0

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 3.8.0 - 2024-07-04
+### Added
+- Trade
+  - Spot
+    - `POST /api/v3/orderList/oto`
+    - `POST /api/v3/orderList/otoco`
+  - Websocket API
+    - `orderList.place.oto`
+    - `orderList.place.otoco`
+
+### Updated
+- Updated and Resolved documentation issue
+- Updated `Restful` OCO trade deprecated endpoint `POST /api/v3/order/oco` to `POST /api/v3/orderList/oco`
+- Updated `Websocket API` OCO trade deprecated endpoint `orderList.place` to `orderList.place.oco`
+
 ## 3.7.0 - 2024-05-03
 ### Added
 - Convert

README.md

@@ -387,7 +387,7 @@ a 10 minutes period. This package handles the pong responses automatically.
 ```python
 from binance.websocket.spot.websocket_client import SpotWebsocketClient as WebsocketClient
 
-ws_client = WebsocketClient(stream_url='wss://testnet.binance.vision')
+ws_client = WebsocketClient(stream_url='wss://stream.testnet.binance.vision')
 ```
 
 ## Test Case

binance/__version__.py

@@ -1 +1 @@
-__version__ = "3.7.0"
+__version__ = "3.8.0"

binance/spot/__init__.py

@@ -34,6 +34,8 @@ def __init__(self, api_key=None, api_secret=None, **kwargs):
     from binance.spot._trade import get_open_orders
     from binance.spot._trade import get_orders
     from binance.spot._trade import new_oco_order
+    from binance.spot._trade import new_oto_order
+    from binance.spot._trade import new_otoco_order
     from binance.spot._trade import cancel_oco_order
     from binance.spot._trade import get_oco_order
     from binance.spot._trade import get_oco_orders

binance/spot/_blvt.py

@@ -99,7 +99,7 @@ def user_limit_info(self, **kwargs):
 
     GET /sapi/v1/blvt/userLimit
 
-    https://binance-docs.github.io/apidocs/spot/en/#get-blvt-user-limit-info
+    https://binance-docs.github.io/apidocs/spot/en/#get-blvt-user-limit-info-user_data
 
     Keyword Args:
         tokenName (str, optional): BTCDOWN, BTCUP

binance/spot/_futures.py

@@ -13,7 +13,7 @@ def futures_transfer(self, asset: str, amount: float, type: int, **kwargs):
 
     POST /sapi/v1/futures/transfer
 
-    https://binance-docs.github.io/apidocs/spot/en/#new-future-account-transfer-futures
+    https://binance-docs.github.io/apidocs/spot/en/#new-future-account-transfer-user_data
 
     Args:
         asset (str): The asset being transferred, e.g. USDT

binance/spot/_gift_card.py

@@ -11,7 +11,7 @@ def gift_card_create_code(self, token: str, amount: float, **kwargs):
     - You have a sufficient balance in your Binance funding wallet
     - You need Enable Withdrawals for the API Key which requests this endpoint.
 
-    https://binance-docs.github.io/apidocs/spot/en/#create-a-binance-code-user_data
+    https://binance-docs.github.io/apidocs/spot/en/#create-a-single-token-gift-card-user_data
 
     Args:
       token (str): The coin type contained in the Binance Code
@@ -36,7 +36,7 @@ def gift_card_redeem_code(self, code: str, **kwargs):
 
     Please note that if you enter the wrong code 5 times within 24 hours, you will no longer be able to redeem any Binance Code that day.
 
-    https://binance-docs.github.io/apidocs/spot/en/#redeem-a-binance-code-user_data
+    https://binance-docs.github.io/apidocs/spot/en/#redeem-a-binance-gift-card-user_data
 
     Args:
       code (str): Binance Code
@@ -60,7 +60,7 @@ def gift_card_verify_code(self, referenceNo: str, **kwargs):
 
     Please note that if you enter the wrong binance code 5 times within an hour, you will no longer be able to verify any binance code for that hour.
 
-    https://binance-docs.github.io/apidocs/spot/en/#verify-a-binance-code-user_data
+    https://binance-docs.github.io/apidocs/spot/en/#verify-binance-gift-card-by-gift-card-number-user_data
 
     Args:
       referenceNo (str): reference number

binance/spot/_margin.py

@@ -65,7 +65,7 @@ def margin_all_pairs(self, **kwargs):
 
     GET /sapi/v1/margin/allPairs
 
-    https://binance-docs.github.io/apidocs/spot/en/#get-all-margin-pairs-market_data
+    https://binance-docs.github.io/apidocs/spot/en/#get-all-cross-margin-pairs-market_data
 
     Keyword Args:
         symbol (str, optional)
@@ -158,7 +158,7 @@ def margin_transfer_history(self, asset: str, **kwargs):
 
     GET /sapi/v1/margin/transfer
 
-    https://binance-docs.github.io/apidocs/spot/en/#get-transfer-history-user_data
+    https://binance-docs.github.io/apidocs/spot/en/#get-cross-margin-transfer-history-user_data
 
     Args:
         asset (str)
@@ -246,7 +246,7 @@ def margin_account(self, **kwargs):
 
     GET /sapi/v1/margin/account
 
-    https://binance-docs.github.io/apidocs/spot/en/#query-margin-account-details-user_data
+    https://binance-docs.github.io/apidocs/spot/en/#query-cross-margin-account-details-user_data
 
     Keyword Args:
         recvWindow (int, optional): The value cannot be greater than 60000
@@ -281,7 +281,7 @@ def margin_open_orders(self, **kwargs):
 
     GET /sapi/v1/margin/openOrders
 
-    https://binance-docs.github.io/apidocs/spot/en/#query-margin-account-39-s-open-order-user_data
+    https://binance-docs.github.io/apidocs/spot/en/#query-margin-account-39-s-open-orders-user_data
 
     Keyword Args:
         symbol (str, optional)
@@ -316,7 +316,7 @@ def margin_all_orders(self, symbol: str, **kwargs):
 
     GET /sapi/v1/margin/allOrders
 
-    https://binance-docs.github.io/apidocs/spot/en/#query-margin-account-39-s-all-order-user_data
+    https://binance-docs.github.io/apidocs/spot/en/#query-margin-account-39-s-all-orders-user_data
 
     Args:
         symbol (str)
@@ -417,7 +417,7 @@ def isolated_margin_all_pairs(self, **kwargs):
 
     GET /sapi/v1/margin/isolated/allPairs
 
-    https://binance-docs.github.io/apidocs/spot/en/#get-all-isolated-margin-symbol-user_data
+    https://binance-docs.github.io/apidocs/spot/en/#get-all-isolated-margin-symbol-market_data
 
     Keyword Args:
         symbol (str, optional)

binance/spot/_portfolio_margin.py

@@ -13,7 +13,7 @@ def portfolio_margin_account(self, **kwargs):
 
     GET /sapi/v1/portfolio/account
 
-    https://binance-docs.github.io/apidocs/spot/en/#get-classic-portfolio-margin-account-info-user_data
+    https://binance-docs.github.io/apidocs/spot/en/#get-portfolio-margin-pro-account-info-user_data
 
     Keyword Args:
         recvWindow (int, optional): The value cannot be greater than 60000
@@ -32,7 +32,7 @@ def portfolio_margin_collateral_rate(self):
 
     GET /sapi/v1/portfolio/collateralRate
 
-    https://binance-docs.github.io/apidocs/spot/en/#portfolio-margin-collateral-rate-market_data
+    https://binance-docs.github.io/apidocs/spot/en/#portfolio-margin-pro-collateral-rate-market_data
 
     """
 
@@ -49,7 +49,7 @@ def portfolio_margin_bankruptcy_loan_amount(self, **kwargs):
 
     GET /sapi/v1/portfolio/pmLoan
 
-    https://binance-docs.github.io/apidocs/spot/en/#classic-portfolio-margin-collateral-rate-market_data
+    https://binance-docs.github.io/apidocs/spot/en/#query-portfolio-margin-pro-bankruptcy-loan-amount-user_data
 
     Keyword Args:
         recvWindow (int, optional): The value cannot be greater than 60000
@@ -68,7 +68,7 @@ def portfolio_margin_bankruptcy_loan_repay(self, **kwargs):
 
     POST /sapi/v1/portfolio/repay
 
-    https://binance-docs.github.io/apidocs/spot/en/#portfolio-margin-bankruptcy-loan-repay-user_data
+    https://binance-docs.github.io/apidocs/spot/en/#portfolio-margin-pro-bankruptcy-loan-repay
 
     Keyword Args:
         recvWindow (int, optional): The value cannot be greater than 60000
@@ -89,7 +89,7 @@ def query_classic_portfolio_margin_negative_balance_interest_history(
 
     GET /sapi/v1/portfolio/interest-history
 
-    https://binance-docs.github.io/apidocs/spot/en/#query-classic-portfolio-margin-negative-balance-interest-history-user_data
+    https://binance-docs.github.io/apidocs/spot/en/#query-portfolio-margin-pro-negative-balance-interest-history-user_data
 
     Args:
         asset (str)
@@ -136,7 +136,7 @@ def fund_auto_collection(self, **kwargs):
 
     POST /sapi/v1/portfolio/auto-collection
 
-    https://binance-docs.github.io/apidocs/spot/en/#fund-auto-collection-usdr_data
+    https://binance-docs.github.io/apidocs/spot/en/#fund-auto-collection-user_data
 
     Keyword Args:
         recvWindow (int, optional): The value cannot be greater than 60000
@@ -155,7 +155,7 @@ def bnb_transfer(self, transferSide: str, amount: float, **kwargs):
 
     POST /sapi/v1/portfolio/bnb-transfer
 
-    https://binance-docs.github.io/apidocs/spot/en/#bnb-transfer-usdr_data
+    https://binance-docs.github.io/apidocs/spot/en/#bnb-transfer-user_data
 
     Args:
         transferSide (str)
@@ -240,7 +240,7 @@ def fund_collection_by_asset(self, asset: str, **kwargs):
 
     POST /sapi/v1/portfolio/asset-collection
 
-    https://binance-docs.github.io/apidocs/spot/en/#fund-collection-by-asset-usdr_data
+    https://binance-docs.github.io/apidocs/spot/en/#fund-collection-by-asset-user_data
 
     Args:
         asset (str)

binance/spot/_sub_account.py

@@ -30,7 +30,7 @@ def sub_account_list(self, **kwargs):
 
     GET /sapi/v1/sub-account/list
 
-    https://binance-docs.github.io/apidocs/spot/en/#query-sub-account-list-sapi-for-master-account
+    https://binance-docs.github.io/apidocs/spot/en/#query-sub-account-list-for-master-account
 
     Keyword Args:
         email (str, optional): Sub-account email
@@ -49,7 +49,7 @@ def sub_account_assets(self, email: str, **kwargs):
 
     GET /sapi/v3/sub-account/assets
 
-    https://binance-docs.github.io/apidocs/spot/en/#query-sub-account-assets-sapi-for-master-account
+    https://binance-docs.github.io/apidocs/spot/en/#query-sub-account-assets-for-master-account
 
     Args:
         email (str)
@@ -681,7 +681,7 @@ def sub_account_update_ip_restriction(
 
     POST /sapi/v2/sub-account/subAccountApi/ipRestriction
 
-    https://binance-docs.github.io/apidocs/spot/en/#update-ip-restriction-for-sub-account-api-key-for-master-account
+    https://binance-docs.github.io/apidocs/spot/en/#add-ip-restriction-for-sub-account-api-key-for-master-account
 
     Args:
         email (str): Sub-account email
@@ -861,7 +861,7 @@ def managed_sub_account_trading_trans_log(
 
     GET /sapi/v1/managed-subaccount/queryTransLogForTradeParent
 
-    https://binance-docs.github.io/apidocs/spot/en/#query-managed-sub-account-transfer-log-trading-team-user_data
+    https://binance-docs.github.io/apidocs/spot/en/#query-managed-sub-account-transfer-log-for-trading-team-master-account-user_data
 
     Args:
         email (str): email