feat: Upbit.get_orderbook_levels() 호가 모아보기 단위 정보 조회 지원

Author: designmeme

README.md

@@ -97,11 +97,12 @@ data = res.json()
 |  | 일(Day) 캔들                    | get_candles_day            |
 |  | 주(Week) 캔들                   | get_candles_week           |
 |  | 월(Month) 캔들                  | get_candles_month          |
-|  | 연(Year) 캔들                  | get_candles_year          |
+|  | 연(Year) 캔들                  | get_candles_year           |
 | 시세 체결 조회 | 최근 체결 내역                     | get_trades_ticks           |
 | 시세 현재가 조회 | 현재가 정보                       | get_ticker                 |
 | 시세 현재가 조회 | 마켓 단위 현재가 정보                 | get_tickers_by_quote       |
 | 시세 호가 조회 | 호가 정보                        | get_orderbook              |
+|  | 호가 모아보기 단위 정보                        | get_orderbook_levels       |
 
 ### Requests 사용
 [Requests][requests] 라이브러리를 사용합니다.

upbit/upbit.py

@@ -2168,3 +2168,40 @@ def get_orderbook(self,
         }
 
         return self._request('get', url, params=params, **kwargs)
+
+    def get_orderbook_levels(self,
+                             markets: List[str],
+                             **kwargs) -> Response:
+        """호가 모아보기 단위 정보 조회
+
+        API 요청 및 응답에 대한 자세한 정보는 공식 문서 참고:
+        `Upbit API Doc <https://docs.upbit.com/reference/supported_levels>`_
+
+        :param markets: 마켓 코드 리스트 (ex. ["KRW-BTC"])
+        :param kwargs: `requests.Session.request` 호출에 사용할 파라미터
+
+        :return: API 서버 응답
+
+        Usage::
+
+            upbit = Upbit()
+            res = upbit.get_orderbook_levels(['KRW-BTC'])
+            print(res.json())
+
+            [{
+                "market": "KRW-BTC",
+                "supported_levels": [
+                    0,
+                    10000,
+                    100000,
+                    1000000,
+                    10000000
+                ]
+            }, ...]
+        """
+        url = self._endpoint + "/orderbook/supported_levels"
+        params = {
+            "markets": markets,
+        }
+
+        return self._request('get', url, params=params, **kwargs)