added and fixed endpoints (#53)

* added and fixed endpoints

* added release date

CHANGELOG.md

@@ -1,6 +1,18 @@
 # Changelog
 
-### 3.1.2 - 2022-08-23
+## 3.2.0 - 2022-08-29
+
+### Add
+#### UM Futures
+ - New endpoint `GET /fapi/v1/pmExchangeInfo` to get current Portfolio Margin exchange trading rules.
+#### CM Futures
+ - New endpoint `GET /dapi/v1/pmExchangeInfo` to get current Portfolio Margin exchange trading rules.
+
+### Update
+#### UM Futures
+ - `symbol` is no longer a required parameter in `GET /fapi/v1/premiumIndex`
+
+## 3.1.2 - 2022-08-23
 
 ### Update
 - Fix encoding issue of parameters in `DELETE /fapi/v1/batchOrders`

binance/__version__.py

@@ -1 +1 @@
-__version__ = "3.1.2"
+__version__ = "3.2.0"

binance/cm_futures/__init__.py

@@ -66,3 +66,6 @@ def __init__(self, key=None, secret=None, **kwargs):
     from binance.cm_futures.data_stream import new_listen_key
     from binance.cm_futures.data_stream import renew_listen_key
     from binance.cm_futures.data_stream import close_listen_key
+
+    # PORTFOLIO MARGIN
+    from binance.cm_futures.portfolio_margin import pm_exchange_info

binance/cm_futures/portfolio_margin.py

@@ -0,0 +1,15 @@
+def pm_exchange_info(self, symbol: str = None):
+    """
+    |
+    | **Portfolio Margin Exchange Information**
+    | *Current Portfolio Margin exchange trading rules.*
+
+    :API endpoint: ``GET /dapi/v1/pmExchangeInfo``
+    :API doc: https://binance-docs.github.io/apidocs/delivery/en/#portfolio-margin-exchange-information
+
+    :parameter symbol: string; the trading pair.
+    |
+    """
+
+    params = {"symbol": symbol}
+    return self.query("/dapi/v1/pmExchangeInfo", params)

binance/um_futures/__init__.py

@@ -71,3 +71,6 @@ def __init__(self, key=None, secret=None, **kwargs):
     from binance.um_futures.data_stream import new_listen_key
     from binance.um_futures.data_stream import renew_listen_key
     from binance.um_futures.data_stream import close_listen_key
+
+    # PORTFOLIO MARGIN
+    from binance.um_futures.portfolio_margin import pm_exchange_info

binance/um_futures/market.py

@@ -221,7 +221,7 @@ def mark_price_klines(self, symbol: str, interval: str, **kwargs):
     return self.query("/fapi/v1/markPriceKlines", params)
 
 
-def mark_price(self, symbol: str):
+def mark_price(self, symbol: str = None):
     """
     |
     | **Mark Price and Funding Rate**
@@ -233,7 +233,6 @@ def mark_price(self, symbol: str):
     |
     """
 
-    check_required_parameter(symbol, "symbol")
     params = {
         "symbol": symbol,
     }

binance/um_futures/portfolio_margin.py

@@ -0,0 +1,15 @@
+def pm_exchange_info(self, symbol: str = None):
+    """
+    |
+    | **Portfolio Margin Exchange Information**
+    | *Current Portfolio Margin exchange trading rules.*
+
+    :API endpoint: ``GET /fapi/v1/pmExchangeInfo``
+    :API doc: https://binance-docs.github.io/apidocs/futures/en/#portfolio-margin-endpoints
+
+    :parameter symbol: string; the trading pair.
+    |
+    """
+
+    params = {"symbol": symbol}
+    return self.query("/fapi/v1/pmExchangeInfo", params)

examples/cm_futures/portfolio_margin/pm_exchange_info.py

@@ -0,0 +1,10 @@
+#!/usr/bin/env python
+import logging
+from binance.cm_futures import CMFutures
+from binance.lib.utils import config_logging
+
+config_logging(logging, logging.DEBUG)
+
+cm_futures_client = CMFutures()
+
+logging.info(cm_futures_client.pm_exchange_info())

examples/um_futures/market/mark_price.py

@@ -7,4 +7,4 @@
 
 um_futures_client = UMFutures()
 
-logging.info(um_futures_client.mark_price("BTCUSDT"))
+logging.info(um_futures_client.mark_price())

examples/um_futures/portfolio_margin/pm_exchange_info.py

@@ -0,0 +1,10 @@
+#!/usr/bin/env python
+import logging
+from binance.um_futures import UMFutures
+from binance.lib.utils import config_logging
+
+config_logging(logging, logging.DEBUG)
+
+um_futures_client = UMFutures()
+
+logging.info(um_futures_client.pm_exchange_info())