Exchange

디지털 자산 출금 요청

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

post/v1/withdraws/coin

Request

Base URL
https://api.upbit.com
URL
https://api.upbit.com/v1/withdraws/coin
Auth
none declared

Request body

currencystring required

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

net_typestring required

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

amountstring decimal required

출금하고자 하는 자산의 수량.

숫자 형식의 String으로 입력합니다.

addressstring required

디지털 자산 출금 시 수신 주소.

출금 가능 주소 목록에 등록된 주소만 사용 가능합니다.

secondary_addressstring nullable

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

transaction_type'default' | 'internal'

출금 유형.

default: 일반출금
internal: 바로출금

Example request

{
  "currency": "BTC",
  "net_type": "BTC",
  "amount": "0.01",
  "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  "transaction_type": "default"
}

Response

Object of digital asset withdrawal

typestring required

입출금 종류

uuidstring required

출금의 유일 식별자

currencystring required

조회하고자 하는 통화 코드

net_typestring nullable required

출금 네트워크 유형.

업비트에서 사용하는 블록체인 네트워크 구분자입니다.

[예시] "ETH", "TRX", "SOL"

txidstring nullable required

트랜잭션 ID

출금 처리 상태

WAITING: 대기 중
PROCESSING: 처리 중
DONE: 완료
FAILED: 실패
CANCELLED: 취소됨
REJECTED: 거절됨

created_atstring required

출금 생성 시간

done_atstring nullable

출금 완료 시간. 출금이 완료되지 않은 경우 null로 반환됩니다.

amountstring decimal required

출금하고자 하는 자산의 수량

feestring decimal required

출금 수수료

transaction_type'default' | 'internal' required

출금 유형.

default: 일반출금
internal: 바로출금

is_cancelableboolean nullable required

출금 취소 가능 여부

Example response

{
  "type": "withdraw",
  "uuid": "9f432943-54e0-40b7-825f-b6fec8b42b79",
  "currency": "BTC",
  "net_type": "BTC",
  "state": "WAITING",
  "created_at": "2024-01-01T00:00:00",
  "done_at": "2024-01-01T00:00:00",
  "amount": "0.01",
  "transaction_type": "default"
}

Changes

No recorded changes to this operation across all 1 revision of this API.