Release v3.7.0

Author: alplabin

CHANGELOG.md

@@ -1,6 +1,37 @@
 # Changelog
 
 ## 3.7.0 - 2024-05-03
+### Added
+- Convert
+  - `POST /sapi/v1/convert/limit/placeOrder`
+  - `POST /sapi/v1/convert/limit/cancelOrder`
+  - `GET /sapi/v1/convert/limit/queryOpenOrders`
+
+- Margin
+  - `GET /sapi/v1/margin/available-inventory`
+  - `POST /sapi/v1/margin/manual-liquidation`
+  - `GET /sapi/v1/margin/leverageBracket`
+
+- Market
+  - `GET /api/v3/ticker/tradingDay`
+
+- Trade
+  - `GET /api/v3/myAllocations`
+  - `GET /api/v3/account/commission`
+
+- Wallet
+  - `GET /sapi/v1/capital/deposit/address/list`
+  - `GET /sapi/v1/spot/delist-schedule`
+
+### Updated
+- `POST /sapi/v1/asset/dust-btc` add parameter `accountType`
+- `POST /sapi/v1/asset/dust` add parameter `accountType`
+- `GET /sapi/v1/asset/dribblet` add parameter `accountType`
+- `POST /sapi/v1/margin/order/oco`: New enumerate value `AUTO_BORROW_REPAY` for the field of `sideEffectType`
+- `POST /sapi/v1/margin/order`: New enumerate value `AUTO_BORROW_REPAY` for the field of `sideEffectType`
+- Update documentation
+- Add new handle exception in websocket read_data
+
 ### Removed
 - Bswap
   - `GET /sapi/v1/bswap/pools`

binance/spot/__init__.py

@@ -19,6 +19,7 @@ def __init__(self, api_key=None, api_secret=None, **kwargs):
     from binance.spot._market import ui_klines
     from binance.spot._market import avg_price
     from binance.spot._market import ticker_24hr
+    from binance.spot._market import trading_day_ticker
     from binance.spot._market import ticker_price
     from binance.spot._market import book_ticker
     from binance.spot._market import rolling_window_ticker
@@ -41,6 +42,8 @@ def __init__(self, api_key=None, api_secret=None, **kwargs):
     from binance.spot._trade import my_trades
     from binance.spot._trade import get_order_rate_limit
     from binance.spot._trade import query_prevented_matches
+    from binance.spot._trade import query_allocations
+    from binance.spot._trade import query_commission_rates
 
     # STREAMS
     from binance.spot._data_stream import new_listen_key
@@ -95,6 +98,9 @@ def __init__(self, api_key=None, api_secret=None, **kwargs):
     from binance.spot._margin import get_small_liability_exchange_history
     from binance.spot._margin import get_a_future_hourly_interest_rate
     from binance.spot._margin import adjust_cross_margin_max_leverage
+    from binance.spot._margin import margin_available_inventory
+    from binance.spot._margin import margin_manual_liquidation
+    from binance.spot._margin import liability_coin_leverage_bracket
 
     # WALLET
     from binance.spot._wallet import system_status
@@ -121,11 +127,13 @@ def __init__(self, api_key=None, api_secret=None, **kwargs):
     from binance.spot._wallet import bnb_convertible_assets
     from binance.spot._wallet import convertible_coins
     from binance.spot._wallet import toggle_auto_convertion
+    from binance.spot._wallet import list_deposit_address
     from binance.spot._wallet import cloud_mining_trans_history
     from binance.spot._wallet import convert_transfer
     from binance.spot._wallet import convert_history
     from binance.spot._wallet import one_click_arrival_deposit_apply
     from binance.spot._wallet import balance
+    from binance.spot._wallet import delist_schedule_symbols
 
     # MINING
     from binance.spot._mining import mining_algo_list
@@ -237,6 +245,9 @@ def __init__(self, api_key=None, api_secret=None, **kwargs):
     from binance.spot._convert import send_quote_request
     from binance.spot._convert import accept_quote
     from binance.spot._convert import order_status
+    from binance.spot._convert import place_limit_order
+    from binance.spot._convert import cancel_limit_order
+    from binance.spot._convert import query_limit_open_order
     from binance.spot._convert import get_convert_trade_history
 
     # REBATE

binance/spot/_convert.py

@@ -115,6 +115,88 @@ def order_status(self, **kwargs):
     return self.sign_request("GET", url_path, {**kwargs})
 
 
+def place_limit_order(
+    self,
+    baseAsset: str,
+    quoteAsset: str,
+    limitPrice: float,
+    side: str,
+    expiredType: str,
+    **kwargs
+):
+    """Place limit order (USER_DATA)
+
+    POST /sapi/v1/convert/limit/placeOrder
+
+    https://binance-docs.github.io/apidocs/spot/en/#place-limit-order-user_data
+
+    Args:
+        baseAsset (str): base asset (use the response fromIsBase from GET /sapi/v1/convert/exchangeInfo api to check which one is baseAsset)
+        quoteAsset (str): quote asset
+        limitPrice (float): Symbol limit price (from baseAsset to quoteAsset)
+        side (str): BUY or SELL
+        expiredType (str): 1_D, 3_D, 7_D, 30_D (D means day)
+    Keyword Args:
+        baseAmount (float, optional): Base asset amount. (One of baseAmount or quoteAmount is required)
+        quotrAmount (float, optional): Quote asset amount. (One of baseAmount or quoteAmount is required)
+        walletType (str, optional): SPOT or FUNDING or SPOT_FUNDING. It is to use which type of assets. Default is SPOT.
+        recvWindow (int, optional): The value cannot be greater than 60000
+    """
+    check_required_parameters(
+        [
+            [baseAsset, "baseAsset"],
+            [quoteAsset, "quoteAsset"],
+            [limitPrice, "limitPrice"],
+            [side, "side"],
+            [expiredType, "expiredType"],
+        ]
+    )
+
+    params = {
+        "baseAsset": baseAsset,
+        "quoteAsset": quoteAsset,
+        "limitPrice": limitPrice,
+        "side": side,
+        "expiredType": expiredType,
+        **kwargs,
+    }
+    url_path = "/sapi/v1/convert/limit/placeOrder"
+    return self.sign_request("POST", url_path, params)
+
+
+def cancel_limit_order(self, orderId: str, **kwargs):
+    """Cancel limit order (USER_DATA)
+
+    POST /sapi/v1/convert/limit/cancelOrder
+
+    https://binance-docs.github.io/apidocs/spot/en/#cancel-limit-order-user_data
+
+    Args:
+        orderId (str): The orderId from placeOrder api
+    Keyword Args:
+        recvWindow (int, optional): The value cannot be greater than 60000
+    """
+    check_required_parameter(orderId, "orderId")
+
+    params = {"orderId": orderId, **kwargs}
+    url_path = "/sapi/v1/convert/limit/cancelOrder"
+    return self.sign_request("POST", url_path, params)
+
+
+def query_limit_open_order(self, **kwargs):
+    """Query limit open orders (USER_DATA)
+
+    GET /sapi/v1/convert/limit/queryOpenOrders
+
+    https://binance-docs.github.io/apidocs/spot/en/#query-limit-open-orders-user_data
+
+    Keyword Args:
+        recvWindow (int, optional): The value cannot be greater than 60000
+    """
+    url_path = "/sapi/v1/convert/limit/queryOpenOrders"
+    return self.sign_request("GET", url_path, {**kwargs})
+
+
 def get_convert_trade_history(self, startTime: int, endTime: int, **kwargs):
     """Get Convert Trade History (USER_DATA)
 

binance/spot/_margin.py

@@ -112,9 +112,9 @@ def new_margin_order(self, symbol: str, side: str, type: str, **kwargs):
         icebergQty (float, optional): Used with LIMIT, STOP_LOSS_LIMIT and TAKE_PROFIT_LIMIT to create an iceberg order.
         newOrderRespType (str, optional): Set the response JSON. ACK, RESULT or FULL;
                 MARKET and LIMIT order types default to FULL, all other orders default to ACK.
-        sideEffectType (str, optional): NO_SIDE_EFFECT, MARGIN_BUY, AUTO_REPAY; default NO_SIDE_EFFECT.
+        sideEffectType (str, optional): NO_SIDE_EFFECT, MARGIN_BUY, AUTO_REPAY,AUTO_BORROW_REPAY; default NO_SIDE_EFFECT.
         timeInForce (str, optional): GTC,IOC,FOK
-        isIsolated (str, optional): for isolated margin or not,"TRUE", "FALSE"，default "FALSE".
+        isIsolated (str, optional): for isolated margin or not,"TRUE", "FALSE" default "FALSE".
         recvWindow (int, optional): The value cannot be greater than 60000
     """
 
@@ -512,7 +512,7 @@ def new_margin_oco_order(
         stopIcebergQty (float, optional)
         stopLimitTimeInForce (str, optional): Valid values are GTC/FOK/IOC
         newOrderRespType (str, optional): Set the response JSON
-        sideEffectType (str, optional): NO_SIDE_EFFECT, MARGIN_BUY, AUTO_REPAY; default NO_SIDE_EFFECT
+        sideEffectType (str, optional): NO_SIDE_EFFECT, MARGIN_BUY, AUTO_REPAY,AUTO_BORROW_REPAY; default NO_SIDE_EFFECT
         recvWindow (int, optional): The value cannot be greater than 60000
     """
 
@@ -630,7 +630,7 @@ def get_margin_open_oco_orders(self, **kwargs):
     https://binance-docs.github.io/apidocs/spot/en/#query-margin-account-39-s-open-oco-user_data
 
     Keyword Args:
-        isIsolated (str, optional): For isolated margin or not "TRUE", "FALSE"，default "FALSE"
+        isIsolated (str, optional): For isolated margin or not "TRUE", "FALSE" default "FALSE"
         symbol (str, optional): Mandatory for isolated margin, not supported for cross margin
         recvWindow (int, optional): The value cannot be greater than 60000
     """
@@ -881,3 +881,51 @@ def adjust_cross_margin_max_leverage(self, maxLeverage: int, **kwargs):
     params = {"maxLeverage": maxLeverage, **kwargs}
     url_path = "/sapi/v1/margin/max-leverage"
     return self.sign_request("POST", url_path, params)
+
+
+def margin_available_inventory(self, type: str, **kwargs):
+    """Query Margin Available Inventory (USER_DATA)
+
+    GET /sapi/v1/margin/available-inventory
+
+    https://binance-docs.github.io/apidocs/spot/en/#query-margin-available-inventory-user_data
+
+    Args:
+        type (str): "MARGIN", "ISOLATED"
+    Keyword Args:
+        recvWindow (int, optional): The value cannot be greater than 60000
+    """
+    check_required_parameter(type, "type")
+    payload = {"type": type, **kwargs}
+    return self.sign_request("GET", "/sapi/v1/margin/available-inventory", payload)
+
+
+def margin_manual_liquidation(self, type: str, **kwargs):
+    """Margin manual liquidation(MARGIN)
+
+    POST /sapi/v1/margin/manual-liquidation
+
+    https://binance-docs.github.io/apidocs/spot/en/#margin-manual-liquidation-margin
+
+    Args:
+        type (str): "MARGIN", "ISOLATED"
+    Keyword Args:
+        symbol (str, optional): When type selects ISOLATED, symbol must be filled in
+        recvWindow (int, optional): The value cannot be greater than 60000
+    """
+    check_required_parameters([[type, "type"]])
+    payload = {"type": type, **kwargs}
+    return self.sign_request("POST", "/sapi/v1/margin/manual-liquidation", payload)
+
+
+def liability_coin_leverage_bracket(self, **kwargs):
+    """Query Liability Coin Leverage Bracket in Cross Margin Pro Mode(MARKET_DATA)
+
+    GET /sapi/v1/margin/leverageBracket
+
+    https://binance-docs.github.io/apidocs/spot/en/#query-liability-coin-leverage-bracket-in-cross-margin-pro-mode-market_data
+
+    Keyword Args:
+        recvWindow (int, optional): The value cannot be greater than 60000
+    """
+    return self.sign_request("GET", "/sapi/v1/margin/leverageBracket", kwargs)

binance/spot/_market.py

@@ -228,6 +228,28 @@ def ticker_24hr(self, symbol: str = None, symbols: list = None, **kwargs):
     return self.query("/api/v3/ticker/24hr", params)
 
 
+def trading_day_ticker(self, symbol: str = None, symbols: list = None):
+    """Trading Day Ticker
+
+    GET /api/v3/ticker/tradingDay
+
+    https://binance-docs.github.io/apidocs/spot/en/#trading-day-ticker
+
+    Args:
+        symbol (str, optional): Either symbol or symbols must be provided
+        symbols (list, optional): list of trading pairs
+    Keyword Args:
+        timeZone (str, optional): Default: 0 (UTC)
+        type (str, optional): Supported values: FULL or MINI. If none provided, the default is FULL.
+    """
+    if symbol and symbols:
+        raise ParameterArgumentError("symbol and symbols cannot be sent together.")
+
+    check_type_parameter(symbols, "symbols", list)
+    params = {"symbol": symbol, "symbols": convert_list_to_json_array(symbols)}
+    return self.query("/api/v3/ticker/tradingDay", params)
+
+
 def ticker_price(self, symbol: str = None, symbols: list = None):
     """Symbol Price Ticker
 

binance/spot/_trade.py

@@ -442,7 +442,7 @@ def get_order_rate_limit(self, **kwargs):
 
 
 def query_prevented_matches(self, symbol: str, **kwargs):
-    """Query Prevented Matches
+    """Query Prevented Matches (USER_DATA)
 
     Displays the list of orders that were expired because of STP.
 
@@ -480,3 +480,46 @@ def query_prevented_matches(self, symbol: str, **kwargs):
     params = {"symbol": symbol, **kwargs}
     url_path = "/api/v3/myPreventedMatches"
     return self.sign_request("GET", url_path, params)
+
+
+def query_allocations(self, symbol: str, **kwargs):
+    """Query Cross-Collateral Information (USER_DATA)
+
+    GET /api/v3/myAllocations
+
+    https://binance-docs.github.io/apidocs/spot/en/#query-allocations-user_data
+
+    Args:
+        symbol (str)
+    Keyword Args:
+        startTime (int, optional)
+        endTime (int, optional)
+        fromAllocationId (int, optional)
+        limit (int, optional): Default Value: 500; Max Value: 1000
+        orderId (int, optional)
+        recvWindow (int, optional): The value cannot be greater than 60000
+    """
+    check_required_parameter(symbol, "symbol")
+
+    params = {"symbol": symbol, **kwargs}
+    url_path = "/api/v3/myAllocations"
+    return self.sign_request("GET", url_path, params)
+
+
+def query_commission_rates(self, symbol: str, **kwargs):
+    """Query Commission Rates (USER_DATA)
+
+    GET /api/v3/account/commission
+
+    https://binance-docs.github.io/apidocs/spot/en/#query-commission-rates-user_data
+
+    Args:
+        symbol (str)
+    Keyword Args:
+        recvWindow (int, optional): The value cannot be greater than 60000
+    """
+    check_required_parameter(symbol, "symbol")
+
+    params = {"symbol": symbol, **kwargs}
+    url_path = "/api/v3/account/commission"
+    return self.sign_request("GET", url_path, params)