디지털 자산 출금 요청

디지털 자산 출금을 요청합니다.

API Key 출금 안심차단 비활성화

2026년 7월 9일부터 출금 권한이 포함된 API Key는 발급 시 출금 안심차단이 자동으로 적용됩니다. 출금 안심차단이 적용된 API Key로는 출금 API를 호출할 수 없습니다.

출금 API를 사용하려면 업비트 모바일 앱의 [더보기 > 인증/보안 > Open API 관리 > 활성] 페이지에서 해당 API Key를 선택한 후, 출금 안심차단 토글을 비활성화해 주세요.

출금 허용 주소 등록

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

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

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

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

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

네트워크 타입("net_type")은 필수 파라미터입니다.
네트워크 타입("net_type")은 디지털 자산 입출금시 실제 자산이 이동되는 블록체인 네트워크(대상 체인)를 지정하기 위한 식별자 필드(예: BTC)입니다. 디지털 자산 출금 시 필수 파라미터로, 정상적인 입출금 진행을 위해 정확한 식별자 값을 사용해야 합니다. 디지털 자산 출금 API 호출 시 사전에 출금 허용 주소 목록 조회 API를 호출하여 응답으로부터 정확한 네트워크 타입 값을 참조하여 사용하시기 바랍니다.
POST API에 대한 Form 방식 요청은 2022년 3월 1일부로 지원이 종료되었습니다.
Form 방식 지원 종료에 따라 Urlencoded Form 방식으로 전송하는 POST 요청에 대한 정상적인 동작을 보장하지 않습니다. 반드시 JSON 형식으로 요청 본문(Body)을 전송해주시기 바랍니다.
반영 버전 반영 일자 변경 사항
- 2023-05-22 네트워크 타입(net_type) 필드 추가
- 2020-05-29 transaction_type 필드 추가
- 2019-04-23 바로 출금 기능 지원
Rate Limit
초당 최대 30회 호출할 수 있습니다. 포켓 단위로 측정되며 [Exchange 기본 그룹] 내에서 요청 가능 횟수를 공유합니다. Rate Limit은 요청 처리량을 보장하는 기준이 아니며, 트래픽 상황이나 서비스 안정성 확보 필요에 따라 제한 또는 조정될 수 있습니다.

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

Body Params

디지털 자산 출금

string
required

출금하고자 하는 디지털 자산의 통화 코드

string
required

출금 주소 등록 후 출금 허용 주소 목록 조회 API를 호출하여 응답에서 각 주소로의 출금시 사용 가능한 “net_type” 값을 확인할 수 있습니다.

string
required

출금하고자 하는 자산의 수량.
숫자 형식의 String으로 입력합니다.

string
required

디지털 자산 출금 시 수신 주소.
출금 가능 주소 목록에 등록된 주소만 사용 가능합니다.

string | null

2차 출금 주소.
일부 디지털 자산의 경우 입출금 주소가 Destination Tag, Memo, 또는 Message와 같은 2차 주소를 포함합니다. 디지털 자산을 수신할 거래소의 수신 주소(입금 주소) 정보에 2차 주소가 포함되어있다면 이 필드를 반드시 포함하여 출금을 요청해야 합니다.

string
enum
Defaults to default

출금 유형.
사용 가능한 값은 다음과 같습니다.

  • default: 일반출금
  • internal: 바로출금
Allowed:
Responses

Language
LoadingLoading…
Response
Choose an example:
application/json
※ This English version is a translation of the original Korean version of the Upbit Developer Center, generated using a third-party tool. In the event of any discrepancies, the Korean version shall take precedence.