get https://api.upbit.com/v1/withdraws/coin_addresses
계정에 등록된 출금 허용 주소 목록을 조회합니다.
출금 허용 주소 등록
출금 기능을 이용하기 위해서는 출금 주소 등록이 반드시 필요합니다.
출금 허용 주소 등록 가이드 를 참고하여 업비트 PC Web에서 [마이페이지 > Open API 관리 > 디지털 자산 출금주소 관리] 메뉴를 통해 출금 허용 주소를 등록해 주세요.
트래블룰에 따른 주소 검증 안내
출금 허용 주소 등록시 업비트는 트래블룰 준수를 위해 해당 주소를 발급한 상대 거래소로 주소 검증을 요청합니다. 상대 거래소가 이를 수신 또는 승인하지 않거나 검증 실패인 경우 출금이 제한될 수 있으므로, 출금 허용 주소 등록 전 해당 거래소에서 지원하는 주소인지 여부를 반드시 확인하시기 바랍니다.
네트워크 타입("net_type")과 네트워크 이름("network_name")
네트워크 타입(net_type)은 디지털 자산 입출금시 실제 자산이 이동되는 블록체인 네트워크(대상 체인)를 지정하기 위한 식별자 필드(예: BTC)입니다. 디지털 자산 출금 시 필수 파라미터로, 정상적인 입출금 진행을 위해 정확한 식별자 값을 사용해야 합니다.
디지털 자산 출금 API 호출 시 사전에 출금 허용 주소 목록 조회 API를 호출한 뒤 응답으로부터 정확한 네트워크 타입 값을 참조하여 사용하시기 바랍니다.
네트워크 이름(network_name)은 블록체인 네트워크의 전체 이름(예: Bitcoin)을 나타내는 필드로서, 사람이 인식할 수 있는 정보이며 식별자로 사용할 수 없습니다. 서비스 UI 등에서 블록체인 네트워크를 표현하는 용도로 사용할 수 있습니다.
출금 허용 주소의 종류에 따라 일부 응답 필드가 null로 반환될 수 있습니다.
[주소 종류에 따른 응답 필드 차이]beneficiary_name필드에는 회원의 이름이, wallet_type필드에는 개인 지갑 이름이 반환됩니다. exchange_name, beneficiary_type 필드가 null로 반환됩니다. exchange_name필드에는 해당 지갑의 거래소 이름이,beneficiary_name필드에는 회원의 이름이 반환되며 wallet_type 필드가 null로 반환됩니다. beneficiary_type은 소유주 유형에 따라 아래와 같이 반환됩니다.[주소 소유주 유형에 따른 응답 필드 차이]
beneficiary_type이 individual로 반환되며 이때 beneficiary_company_name 필드는 null로 반환됩니다. beneficiary_type이 corporate로 반환되며 이때 beneficiary_company_name 필드에 해당 법인명이 반환됩니다. | 반영 버전 | 반영 일자 | 변경 사항 |
|---|---|---|
| v1.5.8 | 2025-07-07 | 수신 계정 관련 필드 추가 (exchange_name, wallet_type, beneficiary_type,beneficiary_name, beneficiary_company_name) |
| - | 2023-11-22 | 네트워크 명(network_name) 필드 추가 |
| - | 2023-05-22 | 네트워크 타입(net_type) 필드 추가 |
Rate Limit
초당 최대 30회 호출할 수 있습니다. 계정단위로 측정되며 [Exchange 기본 그룹] 내에서 요청 가능 횟수를 공유합니다.
API Key Permission
인증이 필요한 API로, [출금조회] 권한이 설정된 API Key를 사용해야 합니다.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.