Merge pull request #33 from uJhin/1.3.4

[Update] Upbit OPEN API Version 1.3.4

Author: uJhin

requirements.txt

@@ -1,48 +1,31 @@
-astroid==2.5
-attrs==20.3.0
-bleach==3.3.0
-bravado==11.0.2
-bravado-core==5.17.0
-certifi==2022.12.7
-chardet==4.0.0
-colorama==0.4.4
-docutils==0.16
-idna==3.1
-isort==5.7.0
-jsonpointer==2.0
-jsonref==0.2
-jsonschema==3.2.0
-keyring==22.0.1
-lazy-object-proxy==1.5.2
-mccabe==0.6.1
-monotonic==1.5
-msgpack==1.0.2
-packaging==20.9
-pkginfo==1.7.0
-Pygments==2.8.0
-PyJWT==2.4.0
-pylint==2.13.0
-pyparsing==2.4.7
-pyrsistent==0.17.3
-python-dateutil==2.8.1
-pytz==2021.1
-pywin32-ctypes==0.2.0
-PyYAML==5.4.1
-readme-renderer==28.0
-requests==2.25.1
-requests-toolbelt==0.9.1
-rfc3986==1.4.0
+arrow==1.2.3
+attrs==23.1.0
+bravado==11.0.3
+bravado-core==5.17.1
+certifi==2023.5.7
+charset-normalizer==3.1.0
+fqdn==1.5.1
+idna==3.4
+isoduration==20.11.0
+jsonpointer==2.3
+jsonref==1.1.0
+jsonschema==4.17.3
+monotonic==1.6
+msgpack==1.0.5
+PyJWT==2.7.0
+pyrsistent==0.19.3
+python-dateutil==2.8.2
+pytz==2023.3
+PyYAML==6.0
+requests==2.30.0
+rfc3339-validator==0.1.4
 rfc3987==1.3.8
-simplejson==3.17.2
-six==1.15.0
-strict-rfc3339==0.7
-swagger-spec-validator==2.7.3
-toml==0.10.2
-tqdm==4.57.0
-twine==3.3.0
-typing-extensions==3.7.4.3
-urllib3==1.26.5
-webcolors==1.11.1
-webencodings==0.5.1
-websockets==10.1
-wrapt==1.12.1
+simplejson==3.19.1
+six==1.16.0
+swagger-spec-validator==3.0.3
+typing_extensions==4.5.0
+upbit-client==1.3.2.0
+uri-template==1.2.0
+urllib3==2.0.2
+webcolors==1.13
+websockets==11.0.3

setup.py

@@ -14,9 +14,9 @@
     version  = pkginfo.CURRENT_VERSION,
     packages = find_packages(),
     install_requires = [
-        'bravado>=11.0.2',
-        'PyJWT>=2.4.0',
-        'websockets>=10.3'
+          'bravado>=11.0.2'
+        , 'PyJWT>=2.4.0'
+        , 'websockets>=10.3'
     ],
     extras_require  = {
         'fido': [
@@ -25,20 +25,22 @@
     },
     python_requires = '>=3.8',
     classifiers     = [
-        'Programming Language :: Python :: 3.8',
-        'Programming Language :: Python :: 3.9',
-        'Programming Language :: Python :: 3.10',
+          'Programming Language :: Python :: 3.8'
+        , 'Programming Language :: Python :: 3.9'
+        , 'Programming Language :: Python :: 3.10'
+        , 'Programming Language :: Python :: 3.11'
+        , 'Programming Language :: Python :: 3.12'
     ],
     keywords        = [
-        'Upbit',
-        'upbit',
-        'upbit-client',
-        'Upbit-Client',
-        'Upbit_client',
-        'Upbit-api-connector',
-        'upbit-api-connector',
-        'Upbit_api_connector',
-        'upbit_api_connector'
+          'Upbit'
+        , 'upbit'
+        , 'upbit-client'
+        , 'Upbit-Client'
+        , 'Upbit_client'
+        , 'Upbit-api-connector'
+        , 'upbit-api-connector'
+        , 'Upbit_api_connector'
+        , 'upbit_api_connector'
     ],
     url                           = 'https://github.com/uJhin/upbit-client',
     download_url                  = 'https://github.com/uJhin/upbit-client/releases',

upbit/__init__.py

@@ -4,7 +4,7 @@
 Please read the official Upbit Client document.
 Documents: https://ujhin.github.io/upbit-client-docs/
 
-- Upbit OPEN API Version: 1.3.2
+- Upbit OPEN API Version: 1.3.4
 - Author: ujhin
 - Email: [email protected]
 - GitHub: https://github.com/uJhin

upbit/client.py

@@ -10,7 +10,7 @@ class Upbit:
 
     - Base URL: https://api.upbit.com
     - Base Path: /v1
-    - Upbit OPEN API Version: 1.3.2
+    - Upbit OPEN API Version: 1.3.4
     - Author: ujhin
     - Email: [email protected]
     - GitHub: https://github.com/uJhin

upbit/models.py

@@ -231,10 +231,15 @@ def Deposit_coin_address(self, **kwargs) -> dict:
 
         [NOTE] 입금 주소 조회 요청 API 유의사항
 
-        입금 주소 생성 요청 이후 아직 발급되지 않은 상태일 경우 deposit_address가 null일 수 있습니다.
+        입금 주소 생성 요청 이후 아직 발급되지 않은 상태일 경우 `deposit_address` 가 `null` 일 수 있습니다.
+        * 네트워크가 일치하지 않는 경우 정상 입출금이 진행되지 않을 수 있습니다.
+        사용하는 주소와 네트워크가 정확히 일치하는지 재확인 후 이용을 부탁드립니다.
 
-        :param currency: Currency symbol
+        :param currency: Currency 코드
         :type currency: str
+
+        :param net_type: 입금 네트워크
+        :type net_type: str
         """
 
         future = self.__client.Deposit.Deposit_coin_address(**kwargs)
@@ -247,7 +252,7 @@ def Deposit_coin_addresses(self) -> dict:
         ## 내가 보유한 자산 리스트를 보여줍니다.
         [NOTE] 입금 주소 조회 요청 API 유의사항
 
-        입금 주소 생성 요청 이후 아직 발급되지 않은 상태일 경우 deposit_address가 null일 수 있습니다.
+        입금 주소 생성 요청 이후 아직 발급되지 않은 상태일 경우 `deposit_address` 가 `null` 일 수 있습니다.
         """
 
         future = self.__client.Deposit.Deposit_coin_addresses()
@@ -263,13 +268,15 @@ def Deposit_generate_coin_address(self, **kwargs) -> dict:
         
         입금 주소의 생성은 서버에서 비동기적으로 이뤄집니다.
         비동기적 생성 특성상 요청과 동시에 입금 주소가 발급되지 않을 수 있습니다.
-        주소 발급 요청 시 결과로 Response1이 반환되며 주소 발급 완료 이전까지 계속 Response1이 반환됩니다.
-        주소가 발급된 이후부터는 새로운 주소가 발급되는 것이 아닌 이전에 발급된 주소가 Response2 형태로 반환됩니다.
+        주소 발급 요청 시 결과로 `Response1` 이 반환되며 주소 발급 완료 이전까지 계속 `Response1` 이 반환됩니다.
+        주소가 발급된 이후부터는 새로운 주소가 발급되는 것이 아닌 이전에 발급된 주소가 `Response2` 형태로 반환됩니다.
         정상적으로 주소가 생성되지 않는다면 일정 시간 이후 해당 API를 다시 호출해주시길 부탁드립니다.
 
-
         :param currency: Currency 코드
         :type currency: str
+
+        :param net_type: 입금 네트워크
+        :type net_type: str
         """
 
         future = self.__client.Deposit.Deposit_generate_coin_address(**kwargs)
@@ -592,8 +599,11 @@ def Withdraw_chance(self, **kwargs) -> dict:
 
         ## 해당 통화의 가능한 출금 정보를 확인한다.
 
-        :param currency: Currency Symbol
+        :param currency: 자산 코드
         :type currency: str
+
+        :param net_type: 출금 네트워크
+        :type net_type: str
         """
 
         future = self.__client.Withdraw.Withdraw_chance(**kwargs)
@@ -609,10 +619,15 @@ def Withdraw_coin(self, **kwargs) -> dict:
 
         업비트 회원의 주소가 아닌 주소로 바로출금을 요청하는 경우, 출금이 정상적으로 수행되지 않습니다.
         반드시 주소를 확인 후 출금을 진행하시기 바랍니다.
+        * 네트워크가 일치하지 않는 경우 정상 입출금이 진행되지 않을 수 있습니다.
+        사용하는 주소와 네트워크가 정확히 일치하는지 재확인 후 이용을 부탁드립니다.
 
-        :param currency: Currency 코드
+        :param currency: 자산 코드
         :type currency: str
 
+        :param net_type: 출금 네트워크
+        :type net_type: str
+
         :param amount: 출금 수량
         :type amount: str
 
@@ -703,3 +718,23 @@ def Withdraw_krw(self, **kwargs) -> dict:
 
         future = self.__client.Withdraw.Withdraw_krw(**kwargs)
         return HTTPFutureExtractor.future_extraction(future)
+
+    def Withdraw_coin_addresses(self, **kwargs) -> dict:
+        """
+        [GET] 출금 허용 주소 리스트 조회
+
+        ## 등록된 출금 허용 주소 목록을 조회한다.
+
+        [NOTE] 출금 기능을 이용하기 위해서는 주소 등록이 필요합니다.
+
+        Open API를 통해 디지털 자산을 출금하기 위해서는 출금 허용 주소 등록이 필요합니다.
+        * 네트워크가 일치하지 않는 경우 정상 입출금이 진행되지 않을 수 있습니다.
+        사용하는 주소와 네트워크가 정확히 일치하는지 재확인 후 이용을 부탁드립니다.
+
+        ### 출금 허용 주소 등록 방법
+        업비트 웹 > [MY] > [Open API 관리] > [디지털 자산 출금주소 관리] 페이지에서 진행하실 수 있습니다.
+        """
+
+        future = self.__client.Withdraw.Withdraw_coin_addresses(**kwargs)
+        return HTTPFutureExtractor.future_extraction(future)
+

upbit/pkginfo.py

@@ -4,7 +4,7 @@
 Please read the official Upbit Client document.
 Documents: https://ujhin.github.io/upbit-client-docs/
 
-- Upbit OPEN API Version: 1.3.2
+- Upbit OPEN API Version: 1.3.4
 - Author: ujhin
 - Email: [email protected]
 - GitHub: https://github.com/uJhin
@@ -28,7 +28,7 @@ def _get_versions(package_name):
 
 PACKAGE_NAME     = "upbit-client"
 
-OPEN_API_VERSION = "1.3.2"
+OPEN_API_VERSION = "1.3.4"
 CURRENT_VERSION  = OPEN_API_VERSION+".0"
 
 RELEASED_VERSION = _get_versions(PACKAGE_NAME)