Release v1.15.0 (#160)

Co-authored-by: Alexander Tanti <tantialex@users.noreply.github.com>

Author: tantialex

CHANGELOG.md

@@ -1,6 +1,15 @@
 # Changelog
 
-## 1.14.0 - TBA
+## 1.15.0 - 2022-07-19
+
+### Added
+- New endpoint for Margin:
+  - `POST /sapi/v3/asset/getUserAsset` to get user assets.
+
+- New endpoint for Wallet:
+  - `GET /sapi/v1/margin/dribblet` to query the historical information of user's margin account small-value asset conversion BNB.
+
+## 1.14.0 - 2022-07-04
 
 ### Added
 

binance/__version__.py

@@ -1 +1 @@
-__version__ = "1.14.0"
+__version__ = "1.15.0"

binance/spot/__init__.py

@@ -95,6 +95,7 @@ def __init__(self, key=None, secret=None, **kwargs):
     from binance.spot.margin import isolated_margin_fee
     from binance.spot.margin import isolated_margin_tier
     from binance.spot.margin import margin_order_usage
+    from binance.spot.margin import margin_dust_log
 
     # SAVINGS
     from binance.spot.savings import savings_flexible_products
@@ -141,6 +142,7 @@ def __init__(self, key=None, secret=None, **kwargs):
     from binance.spot.wallet import asset_detail
     from binance.spot.wallet import trade_fee
     from binance.spot.wallet import funding_wallet
+    from binance.spot.wallet import user_asset
     from binance.spot.wallet import api_key_permissions
     from binance.spot.wallet import bnb_convertible_assets
 

binance/spot/margin.py

@@ -922,3 +922,24 @@ def margin_order_usage(self, **kwargs):
     """
 
     return self.sign_request("GET", "/sapi/v1/margin/rateLimit/order", kwargs)
+
+
+def margin_dust_log(self, **kwargs):
+    """Margin Dust Log (USER_DATA)
+
+    Query the historical information of user's margin account small-value asset conversion BNB.
+
+    Weight(IP): 1
+
+    GET /sapi/v1/margin/dribblet
+
+    https://binance-docs.github.io/apidocs/spot/en/#margin-dustlog-user_data
+
+    Keyword Args:
+        startTime (int, optional): UTC timestamp in ms
+        endTime (int, optional): UTC timestamp in ms
+        recvWindow (int, optional): The value cannot be greater than 60000
+    """
+
+    url_path = "/sapi/v1/margin/dribblet"
+    return self.sign_request("GET", url_path, {**kwargs})

binance/spot/wallet.py

@@ -356,6 +356,27 @@ def funding_wallet(self, **kwargs):
     return self.sign_request("POST", "/sapi/v1/asset/get-funding-asset", kwargs)
 
 
+def user_asset(self, **kwargs):
+    """User Asset (USER_DATA)
+
+    Get user assets, just for positive data.
+
+    Weight(IP): 5
+
+    POST /sapi/v3/asset/getUserAsset
+
+    https://binance-docs.github.io/apidocs/spot/en/#user-asset-user_data
+
+    Keyword Args:
+        asset (str, optional): If asset is blank, then query all positive assets user have.
+        needBtcValuation (str, optional)
+        recvWindow (int, optional): The value cannot be greater than 60000
+    """
+
+    url_path = "/sapi/v3/asset/getUserAsset"
+    return self.sign_request("POST", url_path, {**kwargs})
+
+
 def api_key_permissions(self, **kwargs):
     """Get API Key Permission (USER_DATA)
 

docs/source/binance.spot.margin.rst

@@ -171,4 +171,8 @@ Query Isolated Margin Tier Data (USER_DATA)
 
 Query Current Margin Order Count Usage (TRADE)
 ----------------------------------------------
-.. autofunction:: binance.spot.margin.margin_order_usage
+.. autofunction:: binance.spot.margin.margin_order_usage
+
+Margin Dust Log (USER_DATA)
+---------------------------
+.. autofunction:: binance.spot.margin.margin_dust_log

docs/source/binance.spot.wallet.rst

@@ -77,6 +77,10 @@ Funding Wallet (USER_DATA)
 --------------------------
 .. autofunction:: binance.spot.wallet.funding_wallet
 
+User Asset (USER_DATA)
+----------------------
+.. autofunction:: binance.spot.wallet.user_asset
+
 API Key Permission (USER_DATA)
 ------------------------------
 .. autofunction:: binance.spot.wallet.api_key_permissions

examples/spot/margin/margin_dust_log.py

@@ -0,0 +1,23 @@
+#!/usr/bin/env python
+
+import logging
+from binance.spot import Spot as Client
+from binance.lib.utils import config_logging
+from binance.error import ClientError
+
+config_logging(logging, logging.DEBUG)
+
+key = ""
+secret = ""
+
+client = Client(key, secret)
+
+try:
+    response = client.margin_dust_log(recvWindow=5000)
+    logging.info(response)
+except ClientError as error:
+    logging.error(
+        "Found error. status: {}, error code: {}, error message: {}".format(
+            error.status_code, error.error_code, error.error_message
+        )
+    )

examples/spot/wallet/user_asset.py

@@ -0,0 +1,23 @@
+#!/usr/bin/env python
+
+import logging
+from binance.spot import Spot as Client
+from binance.lib.utils import config_logging
+from binance.error import ClientError
+
+config_logging(logging, logging.DEBUG)
+
+key = ""
+secret = ""
+
+client = Client(key, secret)
+
+try:
+    response = client.user_asset(asset="BNB", recvWindow=5000)
+    logging.info(response)
+except ClientError as error:
+    logging.error(
+        "Found error. status: {}, error code: {}, error message: {}".format(
+            error.status_code, error.error_code, error.error_message
+        )
+    )

tests/spot/margin/test_margin_dust_log.py

@@ -0,0 +1,28 @@
+import responses
+
+from binance.spot import Spot as Client
+from tests.util import random_str
+from urllib.parse import urlencode
+from tests.util import mock_http_response
+
+mock_item = {"key_1": "value_1", "key_2": "value_2"}
+mock_exception = {"code": -1, "msg": "error message"}
+
+key = random_str()
+secret = random_str()
+
+params = {"recvWindow": 5000}
+
+
+@mock_http_response(
+    responses.GET,
+    "/sapi/v1/margin/dribblet\\?" + urlencode(params),
+    mock_item,
+    200,
+)
+def test_margin_dust_log():
+    """Tests the API endpoint to margin dustlog"""
+
+    client = Client(key, secret)
+    response = client.margin_dust_log(**params)
+    response.should.equal(mock_item)

tests/spot/wallet/test_user_asset.py

@@ -0,0 +1,28 @@
+import responses
+
+from binance.spot import Spot as Client
+from tests.util import random_str
+from urllib.parse import urlencode
+from tests.util import mock_http_response
+
+mock_item = {"key_1": "value_1", "key_2": "value_2"}
+mock_exception = {"code": -1, "msg": "error message"}
+
+key = random_str()
+secret = random_str()
+
+params = {"asset": "BNB", "recvWindow": 5000}
+
+
+@mock_http_response(
+    responses.POST,
+    "/sapi/v3/asset/getUserAsset\\?" + urlencode(params),
+    mock_item,
+    200,
+)
+def test_user_asset():
+    """Tests the API endpoint to user asset"""
+
+    client = Client(key, secret)
+    response = client.user_asset(**params)
+    response.should.equal(mock_item)