python-binance 1.0.26__tar.gz → 1.0.27__tar.gz

{python_binance-1.0.26/python_binance.egg-info → python_binance-1.0.27}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-binance
-Version: 1.0.26
+Version: 1.0.27
 Summary: Binance REST API python implementation
 Home-page: https://github.com/sammchardy/python-binance
 Author: Sam McHardy
@@ -31,7 +31,7 @@ Requires-Dist: websockets
 Requires-Dist: pycryptodome
 
 =================================
-Welcome to python-binance v1.0.26
+Welcome to python-binance v1.0.27
 =================================
 
 .. image:: https://img.shields.io/pypi/v/python-binance.svg

{python_binance-1.0.26 → python_binance-1.0.27}/README.rst

@@ -1,5 +1,5 @@
 =================================
-Welcome to python-binance v1.0.26
+Welcome to python-binance v1.0.27
 =================================
 
 .. image:: https://img.shields.io/pypi/v/python-binance.svg

{python_binance-1.0.26 → python_binance-1.0.27}/binance/__init__.py

@@ -4,7 +4,7 @@
 
 """
 
-__version__ = "1.0.26"
+__version__ = "1.0.27"
 
 from binance.async_client import AsyncClient  # noqa
 from binance.client import Client  # noqa
@@ -12,6 +12,8 @@ from binance.ws.depthcache import (
     DepthCacheManager,  # noqa
     OptionsDepthCacheManager,  # noqa
     ThreadedDepthCacheManager,  # noqa
+    FuturesDepthCacheManager,  # noqa
+    OptionsDepthCacheManager,  # noqa
 )
 from binance.ws.streams import (
     BinanceSocketManager,  # noqa
@@ -23,7 +25,7 @@ from binance.ws.keepalive_websocket import KeepAliveWebsocket  # noqa
 
 from binance.ws.reconnecting_websocket import ReconnectingWebsocket  # noqa
 
-from binance.ws.constants import * # noqa
+from binance.ws.constants import *  # noqa
 
 from binance.exceptions import *  # noqa
 

{python_binance-1.0.26 → python_binance-1.0.27}/binance/async_client.py

@@ -36,6 +36,7 @@ class AsyncClient(BaseClient):
         private_key: Optional[Union[str, Path]] = None,
         private_key_pass: Optional[str] = None,
         https_proxy: Optional[str] = None,
+        time_unit: Optional[str] = None,
     ):
         self.https_proxy = https_proxy
         self.loop = loop or get_loop()
@@ -49,6 +50,7 @@ class AsyncClient(BaseClient):
             testnet,
             private_key,
             private_key_pass,
+            time_unit=time_unit,
         )
 
     @classmethod
@@ -128,10 +130,25 @@ class AsyncClient(BaseClient):
                 uri = f"{uri}?{kwargs['params']}"
                 kwargs.pop("params")
 
+        data = kwargs.get("data")
+        if data is not None:
+            del kwargs["data"]
+
+        if (
+            signed and self.PRIVATE_KEY and data
+        ):  # handle issues with signing using eddsa/rsa and POST requests
+            dict_data = Client.convert_to_dict(data)
+            signature = dict_data["signature"] if "signature" in dict_data else None
+            if signature:
+                del dict_data["signature"]
+            url_encoded_data = urlencode(dict_data)
+            data = f"{url_encoded_data}&signature={signature}"
+
         async with getattr(self.session, method)(
             yarl.URL(uri, encoded=True),
             proxy=self.https_proxy,
             headers=headers,
+            data=data,
             **kwargs,
         ) as response:
             self.response = response
@@ -1736,6 +1753,11 @@ class AsyncClient(BaseClient):
         return await self._request_futures_data_api(
             "get", "globalLongShortAccountRatio", data=params
         )
+        
+    async def futures_taker_longshort_ratio(self, **params):
+        return await self._request_futures_data_api(
+            "get", "takerlongshortRatio", data=params
+        )
 
     async def futures_ticker(self, **params):
         return await self._request_futures_api("get", "ticker/24hr", data=params)
@@ -1746,6 +1768,13 @@ class AsyncClient(BaseClient):
     async def futures_orderbook_ticker(self, **params):
         return await self._request_futures_api("get", "ticker/bookTicker", data=params)
 
+    async def futures_index_price_constituents(self, **params):
+        return await self._request_futures_api("get", "constituents", data=params)
+
+    futures_index_price_constituents.__doc__ = (
+        Client.futures_index_price_constituents.__doc__
+    )
+
     async def futures_liquidation_orders(self, **params):
         return await self._request_futures_api(
             "get", "forceOrders", signed=True, data=params
@@ -2043,6 +2072,13 @@ class AsyncClient(BaseClient):
             "get", "ticker/bookTicker", data=params
         )
 
+    async def futures_coin_index_price_constituents(self, **params):
+        return await self._request_futures_coin_api("get", "constituents", data=params)
+
+    futures_coin_index_price_constituents.__doc__ = (
+        Client.futures_coin_index_price_constituents.__doc__
+    )
+
     async def futures_coin_liquidation_orders(self, **params):
         return await self._request_futures_coin_api(
             "get", "forceOrders", signed=True, data=params
@@ -2427,6 +2463,28 @@ class AsyncClient(BaseClient):
     ====================================================================================================================
     """
 
+    async def papi_stream_get_listen_key(self):
+        res = await self._request_papi_api("post", "listenKey", signed=False, data={})
+        return res["listenKey"]
+
+    papi_stream_get_listen_key.__doc__ = Client.papi_stream_get_listen_key.__doc__
+
+    async def papi_stream_keepalive(self, listenKey):
+        params = {"listenKey": listenKey}
+        return await self._request_papi_api(
+            "put", "listenKey", signed=False, data=params
+        )
+
+    papi_stream_keepalive.__doc__ = Client.papi_stream_keepalive.__doc__
+
+    async def papi_stream_close(self, listenKey):
+        params = {"listenKey": listenKey}
+        return await self._request_papi_api(
+            "delete", "listenKey", signed=False, data=params
+        )
+
+    papi_stream_close.__doc__ = Client.papi_stream_close.__doc__
+
     async def papi_get_balance(self, **params):
         return await self._request_papi_api("get", "balance", signed=True, data=params)
 
@@ -3523,7 +3581,7 @@ class AsyncClient(BaseClient):
     async def ws_cancel_order(self, **params):
         return await self._ws_api_request("order.cancel", True, params)
 
-    cancel_order.__doc__ = cancel_order.__doc__
+    ws_cancel_order.__doc__ = Client.ws_cancel_order.__doc__
 
     async def cancel_all_open_orders(self, **params):
         return await self._delete("openOrders", True, data=params)
@@ -3533,105 +3591,173 @@ class AsyncClient(BaseClient):
             params["newClientOrderId"] = self.SPOT_ORDER_PREFIX + self.uuid22()
         return await self._post("order/cancelReplace", signed=True, data=params)
 
+    cancel_replace_order.__doc__ = Client.cancel_replace_order.__doc__
+
     async def ws_cancel_and_replace_order(self, **params):
         return await self._ws_api_request("order.cancelReplace", True, params)
 
+    ws_cancel_and_replace_order.__doc__ = Client.ws_cancel_and_replace_order.__doc__
+
     async def ws_get_open_orders(self, **params):
         return await self._ws_api_request("openOrders.status", True, params)
 
+    ws_get_open_orders.__doc__ = Client.ws_get_open_orders.__doc__
+
     async def ws_cancel_all_open_orders(self, **params):
         return await self._ws_api_request("openOrders.cancelAll", True, params)
 
+    ws_cancel_all_open_orders.__doc__ = Client.ws_cancel_all_open_orders.__doc__
+
     async def ws_create_oco_order(self, **params):
         return await self._ws_api_request("orderList.place.oco", True, params)
 
+    ws_create_oco_order.__doc__ = Client.ws_create_oco_order.__doc__
+
     async def ws_create_oto_order(self, **params):
         return await self._ws_api_request("orderList.place.oto", True, params)
 
+    ws_create_oto_order.__doc__ = Client.ws_create_oto_order.__doc__
+
     async def ws_create_otoco_order(self, **params):
         return await self._ws_api_request("orderList.place.otoco", True, params)
 
+    ws_create_otoco_order.__doc__ = Client.ws_create_otoco_order.__doc__
+
     async def ws_get_oco_order(self, **params):
         return await self._ws_api_request("orderList.status", True, params)
 
+    ws_get_oco_order.__doc__ = Client.ws_get_oco_order.__doc__
+
     async def ws_cancel_oco_order(self, **params):
         return await self._ws_api_request("orderList.cancel", True, params)
 
+    ws_cancel_oco_order.__doc__ = Client.ws_cancel_oco_order.__doc__
+
     async def ws_get_oco_open_orders(self, **params):
         return await self._ws_api_request("openOrderLists.status", True, params)
 
+    ws_get_oco_open_orders.__doc__ = Client.ws_get_oco_open_orders.__doc__
+
     async def ws_create_sor_order(self, **params):
         return await self._ws_api_request("sor.order.place", True, params)
 
+    ws_create_sor_order.__doc__ = Client.ws_create_sor_order.__doc__
+
     async def ws_create_test_sor_order(self, **params):
         return await self._ws_api_request("sor.order.test", True, params)
 
+    ws_create_test_sor_order.__doc__ = Client.ws_create_test_sor_order.__doc__
+
     async def ws_get_account(self, **params):
         return await self._ws_api_request("account.status", True, params)
 
+    ws_get_account.__doc__ = Client.ws_get_account.__doc__
+
     async def ws_get_account_rate_limits_orders(self, **params):
         return await self._ws_api_request("account.rateLimits.orders", True, params)
 
+    ws_get_account_rate_limits_orders.__doc__ = Client.ws_get_account_rate_limits_orders.__doc__
+
     async def ws_get_all_orders(self, **params):
         return await self._ws_api_request("allOrders", True, params)
 
+    ws_get_all_orders.__doc__ = Client.ws_get_all_orders.__doc__
+
     async def ws_get_my_trades(self, **params):
         return await self._ws_api_request("myTrades", True, params)
 
+    ws_get_my_trades.__doc__ = Client.ws_get_my_trades.__doc__
+
     async def ws_get_prevented_matches(self, **params):
         return await self._ws_api_request("myPreventedMatches", True, params)
 
+    ws_get_prevented_matches.__doc__ = Client.ws_get_prevented_matches.__doc__
+
     async def ws_get_allocations(self, **params):
         return await self._ws_api_request("myAllocations", True, params)
 
+    ws_get_allocations.__doc__ = Client.ws_get_allocations.__doc__
+
     async def ws_get_commission_rates(self, **params):
         return await self._ws_api_request("account.commission", True, params)
 
+    ws_get_commission_rates.__doc__ = Client.ws_get_commission_rates.__doc__
+
     async def ws_get_order_book(self, **params):
         return await self._ws_api_request("depth", False, params)
 
+    ws_get_order_book.__doc__ = Client.ws_get_order_book.__doc__
+
     async def ws_get_recent_trades(self, **params):
         return await self._ws_api_request("trades.recent", False, params)
 
+    ws_get_recent_trades.__doc__ = Client.ws_get_recent_trades.__doc__
+
     async def ws_get_historical_trades(self, **params):
         return await self._ws_api_request("trades.historical", False, params)
 
+    ws_get_historical_trades.__doc__ = Client.ws_get_historical_trades.__doc__
+
     async def ws_get_aggregate_trades(self, **params):
         return await self._ws_api_request("trades.aggregate", False, params)
 
+    ws_get_aggregate_trades.__doc__ = Client.ws_get_aggregate_trades.__doc__
+
     async def ws_get_klines(self, **params):
         return await self._ws_api_request("klines", False, params)
 
+    ws_get_klines.__doc__ = Client.ws_get_klines.__doc__
+
     async def ws_get_uiKlines(self, **params):
         return await self._ws_api_request("uiKlines", False, params)
 
+    ws_get_uiKlines.__doc__ = Client.ws_get_uiKlines.__doc__
+
     async def ws_get_avg_price(self, **params):
         return await self._ws_api_request("avgPrice", False, params)
 
+    ws_get_avg_price.__doc__ = Client.ws_get_avg_price.__doc__
+
     async def ws_get_ticker(self, **params):
         return await self._ws_api_request("ticker.24hr", False, params)
 
+    ws_get_ticker.__doc__ = Client.ws_get_ticker.__doc__
+
     async def ws_get_trading_day_ticker(self, **params):
         return await self._ws_api_request("ticker.tradingDay", False, params)
 
+    ws_get_trading_day_ticker.__doc__ = Client.ws_get_trading_day_ticker.__doc__
+
     async def ws_get_symbol_ticker_window(self, **params):
         return await self._ws_api_request("ticker", False, params)
 
+    ws_get_symbol_ticker_window.__doc__ = Client.ws_get_symbol_ticker_window.__doc__
+
     async def ws_get_symbol_ticker(self, **params):
         return await self._ws_api_request("ticker.price", False, params)
 
+    ws_get_symbol_ticker.__doc__ = Client.ws_get_symbol_ticker.__doc__
+
     async def ws_get_orderbook_ticker(self, **params):
         return await self._ws_api_request("ticker.book", False, params)
 
+    ws_get_orderbook_ticker.__doc__ = Client.ws_get_orderbook_ticker.__doc__
+
     async def ws_ping(self, **params):
         return await self._ws_api_request("ping", False, params)
 
+    ws_ping.__doc__ = Client.ws_ping.__doc__
+
     async def ws_get_time(self, **params):
         return await self._ws_api_request("time", False, params)
 
+    ws_get_time.__doc__ = Client.ws_get_time.__doc__
+
     async def ws_get_exchange_info(self, **params):
         return await self._ws_api_request("exchangeInfo", False, params)
 
+    ws_get_exchange_info.__doc__ = Client.ws_get_exchange_info.__doc__
+
     ####################################################
     # FUTURES WS API Endpoints
     ####################################################
@@ -3886,3 +4012,12 @@ class AsyncClient(BaseClient):
         )
 
     margin_max_borrowable.__doc__ = Client.margin_max_borrowable.__doc__
+
+    ####################################################
+    # Futures Data
+    ####################################################
+
+    async def futures_historical_data_link(self, **params):
+        return await self._request_margin_api("get", "futures/data/histDataLink", signed=True, data=params)
+
+    futures_historical_data_link.__doc__ = Client.futures_historical_data_link.__doc__

{python_binance-1.0.26 → python_binance-1.0.27}/binance/base_client.py

@@ -160,6 +160,7 @@ class BaseClient:
         private_key: Optional[Union[str, Path]] = None,
         private_key_pass: Optional[str] = None,
         loop: Optional[asyncio.AbstractEventLoop] = None,
+        time_unit: Optional[str] = None,
     ):
         """Binance API Client constructor
 
@@ -175,6 +176,8 @@ class BaseClient:
         :type private_key: optional - str or Path
         :param private_key_pass: Password of private key
         :type private_key_pass: optional - str
+        :param time_unit: Time unit to use for requests. Supported values: "MILLISECOND", "MICROSECOND"
+        :type time_unit: optional - str
 
         """
 
@@ -191,6 +194,7 @@ class BaseClient:
 
         self.API_KEY = api_key
         self.API_SECRET = api_secret
+        self.TIME_UNIT = time_unit
         self._is_rsa = False
         self.PRIVATE_KEY: Any = self._init_private_key(private_key, private_key_pass)
         self.session = self._init_session()
@@ -199,6 +203,8 @@ class BaseClient:
         self.testnet = testnet
         self.timestamp_offset = 0
         ws_api_url = self.WS_API_TESTNET_URL if testnet else self.WS_API_URL.format(tld)
+        if self.TIME_UNIT:
+            ws_api_url += f"?timeUnit={self.TIME_UNIT}"
         self.ws_api = WebsocketAPI(url=ws_api_url, tld=tld)
         ws_future_url = (
             self.WS_FUTURES_TESTNET_URL if testnet else self.WS_FUTURES_URL.format(tld)
@@ -215,6 +221,9 @@ class BaseClient:
         if self.API_KEY:
             assert self.API_KEY
             headers["X-MBX-APIKEY"] = self.API_KEY
+        if self.TIME_UNIT:
+            assert self.TIME_UNIT
+            headers["X-MBX-TIME-UNIT"] = self.TIME_UNIT
         return headers
 
     def _init_session(self):
@@ -312,6 +321,11 @@ class BaseClient:
     def encode_uri_component(uri, safe="~()*!.'"):
         return _urlencode.quote(uri, safe=safe)
 
+    @staticmethod
+    def convert_to_dict(list_tuples):
+        dictionary = dict((key, value) for key, value in list_tuples)
+        return dictionary
+
     def _ed25519_signature(self, query_string: str):
         assert self.PRIVATE_KEY
         res = b64encode(