v1

latestOpenAPI 3.0.12026-07-24510443.1 KB

출금(Withdrawal)

디지털 자산 출금 요청

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

post/withdraws/coin

Request body

currencystring required

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

net_typestring required

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

amountstring 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 required

출금 네트워크 유형. 업비트에서 사용하는 블록체인 네트워크 구분자입니다. 출금 요청 시 사용되는 net_type 파라미터는 이 필드와 같은 값을 사용해야 합니다.

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

txidstring nullable required

트랜잭션 ID

출금 처리 상태

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

created_atstring required

출금 생성 시간

done_atstring nullable

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

amountstring required

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

feestring required

출금 수수료

transaction_type'default' | 'internal' required

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

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

is_cancelableboolean 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"
}