디지털 자산 출금 요청

출금 허용 주소 등록

API를 통한 디지털 자산 출금시 출금 대상 주소를 반드시 사전에 출금 허용 주소로 등록해야 합니다. 출금 허용 주소는 업비트 홈페이지를 통해 등록할 수 있으며 API를 통한 등록은 불가합니다. 출금 허용 주소 등록 방법은 출금 허용 주소 등록하기 페이지를 참고해주세요.

트랜잭션 유형 - 일반 출금(default)과 바로 출금(internal)

디지털 자산을 개인 지갑 주소 또는 타 거래소 지갑 주소로 자산을 출금하고자 하는 경우 일반 출금으로 진행합니다. 일반 출금은 실제 블록체인 트랜잭션으로 자산 송금을 진행함에 따라 트랜잭션 확정 시간을 포함한 처리 시간과 출금 수수료가 발생합니다.

업비트 계정 간 디지털 자산 송금 시 바로 출금을 사용할 수 있습니다. 바로 출금은 블록체인을 사용하지 않는 자산 송금 방식으로, 약 1분 내외로 출금이 반영되며 수수료가 발생하지 않습니다. 바로 출금시 반드시 업비트 회원의 지갑 주소로 출금해야 하며, 업비트 회원 주소가 아닌 주소로 출금을 요청하는 경우 출금이 정상적으로 수행되지 않습니다.

일반 출금과 바로 출금에 관한 자세한 사항은 업비트 고객센터 - 자주하는 질문를 참고하시기 바랍니다.

네트워크 타입("net_type")은 필수 파라미터입니다.

네트워크 타입("net_type")은 디지털 자산 입출금시 실제 자산이 이동되는 블록체인 네트워크(대상 체인)를 지정하기 위한 식별자 필드(예: BTC)입니다. 디지털 자산 출금 시 필수 파라미터로, 정상적인 입출금 진행을 위해 정확한 식별자 값을 사용해야 합니다. 디지털 자산 출금 API 호출 시 사전에 출금 허용 주소 목록 조회 API를 호출하여 응답으로부터 정확한 네트워크 타입 값을 참조하여 사용하시기 바랍니다.

POST API에 대한 Form 방식 요청은 2022년 3월 1일부로 지원이 종료되었습니다.

Form 방식 지원 종료에 따라 Urlencoded Form 방식으로 전송하는 POST 요청에 대한 정상적인 동작을 보장하지 않습니다. 반드시 JSON 형식으로 요청 본문(Body)을 전송해주시기 바랍니다.

Revision History

반영 버전	반영 일자	변경 사항
-	2023-05-22	네트워크 타입(net_type) 필드 추가
-	2020-05-29	`transaction_type` 필드 추가
-	2019-04-23	바로 출금 기능 지원

Rate Limit

초당 최대 30회 호출할 수 있습니다. 계정단위로 측정되며 [Exchange 기본 그룹] 내에서 요청 가능 횟수를 공유합니다.

API Key Permission

인증이 필요한 API로, [출금하기] 권한이 설정된 API Key를 사용해야 합니다.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.