v3.1.0 release (#32)

Author: 2pd

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 3.1.0 - 2022-06-02
+
+### Add
+
+- New endpoint `GET /fapi/v1/income/asyn` to get Download Id For Futures Transaction History
+- New endpoint `GET /fapi/v1/income/asyn/id` to get Futures Transaction History Download Link by Id
+
+
 ## 3.0.0 - 2022-05-26
 
 - Refactor the connector

binance/__version__.py

@@ -1 +1 @@
-__version__ = "3.0.0"
+__version__ = "3.1.0"

binance/um_futures/__init__.py

@@ -64,6 +64,8 @@ def __init__(self, key=None, secret=None, **kwargs):
     from binance.um_futures.account import force_orders
     from binance.um_futures.account import api_trading_status
     from binance.um_futures.account import commission_rate
+    from binance.um_futures.account import download_transactions_asyn
+    from binance.um_futures.account import aysnc_download_info
 
     # STREAMS
     from binance.um_futures.data_stream import new_listen_key

binance/um_futures/account.py

@@ -780,3 +780,45 @@ def commission_rate(self, symbol: str, **kwargs):
     params = {"symbol": symbol, **kwargs}
 
     return self.sign_request("GET", url_path, params)
+
+
+def download_transactions_asyn(self, startTime: int, endTime: int, **kwargs):
+    """
+    |
+    | **Get Download Id For Futures Transaction History (USER_DATA)**
+
+    :API endpoint: ``GET /fapi/v1/income/asyn``
+    :API doc: https://binance-docs.github.io/apidocs/futures/en/#get-download-id-for-futures-transaction-history-user_data
+
+    :parameter startTime:  int
+    :parameter endTime:  int
+    :parameter recvWindow: optional int
+    |
+    """
+
+    check_required_parameter(startTime, "startTime")
+    check_required_parameter(endTime, "endTime")
+    url_path = "/fapi/v1/income/asyn"
+    params = {"startTime": startTime, "endTime": endTime, **kwargs}
+
+    return self.sign_request("GET", url_path, params)
+
+
+def aysnc_download_info(self, downloadId: str, **kwargs):
+    """
+    |
+    | **Get Futures Transaction History Download Link by Id (USER_DATA)**
+
+    :API endpoint: ``GET /fapi/v1/income/asyn/id``
+    :API doc: https://binance-docs.github.io/apidocs/futures/en/#get-futures-transaction-history-download-link-by-id-user_data
+
+    :parameter downloadId:  string
+    :parameter recvWindow: optional int
+    |
+    """
+
+    check_required_parameter(downloadId, "downloadId")
+    url_path = "/fapi/v1/income/asyn/id"
+    params = {"downloadId": downloadId, **kwargs}
+
+    return self.sign_request("GET", url_path, params)

binance/websocket/.DS_Store

@@ -0,0 +1,22 @@
+#!/usr/bin/env python
+import logging
+from binance.um_futures import UMFutures
+from binance.lib.utils import config_logging
+from binance.error import ClientError
+
+config_logging(logging, logging.DEBUG)
+
+key = ""
+secret = ""
+
+um_futures_client = UMFutures(key=key, secret=secret)
+
+try:
+    response = um_futures_client.aysnc_download_info(downloadId="1")
+    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/um_futures/trade/aysnc_download_info.py

@@ -0,0 +1,24 @@
+#!/usr/bin/env python
+import logging
+from binance.um_futures import UMFutures
+from binance.lib.utils import config_logging
+from binance.error import ClientError
+
+config_logging(logging, logging.DEBUG)
+
+key = ""
+secret = ""
+
+um_futures_client = UMFutures(key=key, secret=secret)
+
+try:
+    response = um_futures_client.download_transactions_asyn(
+        startTime=1641102712000, endTime=1651470712000
+    )
+    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/um_futures/trade/download_transactions_asyn.py

@@ -3,7 +3,7 @@
 import time
 import logging
 from binance.lib.utils import config_logging
-from binance.cm_futures import CMFutures
+from binance.um_futures import UMFutures
 from binance.websocket.um_futures.websocket_client import UMFuturesWebsocketClient
 
 config_logging(logging, logging.DEBUG)
@@ -14,7 +14,7 @@ def message_handler(message):
 
 
 api_key = ""
-client = CMFutures(api_key)
+client = UMFutures(api_key)
 response = client.new_listen_key()
 
 logging.info("Listen key : {}".format(response["listenKey"]))