feat: Upbit.get_orderbook_instruments() 호가 정책 조회 지원

Author: designmeme

README.md

@@ -105,6 +105,7 @@ data = res.json()
 | 시세 현재가 조회 | 마켓 단위 현재가 정보                 | get_tickers_by_quote       |
 | 시세 호가 조회 | 호가 정보                        | get_orderbook              |
 |  | 호가 모아보기 단위 정보                        | get_orderbook_levels       |
+|  | 호가 정책 조회                        | get_orderbook_instruments       |
 
 ### Requests 사용
 [Requests][requests] 라이브러리를 사용합니다.

upbit/upbit.py

@@ -11,6 +11,7 @@
 import requests
 from requests import Response
 from requests.adapters import HTTPAdapter
+from typing_extensions import deprecated
 
 from .exceptions import (
     _ERROR_EXCEPTION_DICT,
@@ -2296,6 +2297,7 @@ def get_orderbook(self,
 
         return self._request('get', url, params=params, **kwargs)
 
+    @deprecated
     def get_orderbook_levels(self,
                              markets: List[str],
                              **kwargs) -> Response:
@@ -2332,3 +2334,43 @@ def get_orderbook_levels(self,
         }
 
         return self._request('get', url, params=params, **kwargs)
+
+    def get_orderbook_instruments(self,
+                                  markets: List[str],
+                                  **kwargs) -> Response:
+        """호가 정책 조회
+
+        API 요청 및 응답에 대한 자세한 정보는 공식 문서 참고:
+        `Upbit API Doc <https://docs.upbit.com/kr/reference/%ED%98%B8%EA%B0%80-%EC%A0%95%EC%B1%85-%EC%A1%B0%ED%9A%8C>`_
+
+        :param markets: 마켓 코드 리스트 (ex. ["KRW-BTC"])
+        :param kwargs: `requests.Session.request` 호출에 사용할 파라미터
+
+        :return: API 서버 응답
+
+        Usage::
+
+            upbit = Upbit()
+            res = upbit.get_orderbook_instruments(['KRW-BTC'])
+            print(res.json())
+
+            [{
+                "market": "KRW-BTC",
+                "quote_currency": "KRW",
+                "tick_size": "1000",
+                "supported_levels": [
+                    "0",
+                    "10000",
+                    "100000",
+                    "1000000",
+                    "10000000",
+                    "100000000"
+                ]
+            }, ...]
+        """
+        url = self._endpoint + "/orderbook/instruments"
+        params = {
+            "markets": markets,
+        }
+
+        return self._request('get', url, params=params, **kwargs)