---
title: "디지털 자산 출금 요청"
method: POST
path: "/withdraws/coin"
tags: ["출금(Withdrawal)"]
---

# 디지털 자산 출금 요청

`POST /withdraws/coin`

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

## Request body

- object
  - `currency` string, required — 출금하고자 하는 디지털 자산의 통화 코드
  - `net_type` string, required — 출금 주소 등록 후 출금 허용 주소 목록 조회 API를 호출하여 응답에서 각 주소로의 출금시 사용 가능한 “net_type” 값을 확인할 수 있습니다.
  - `amount` string, required — 출금하고자 하는 자산의 수량. 숫자 형식의 String으로 입력합니다.
  - `address` string, required — 디지털 자산 출금 시 수신 주소. 출금 가능 주소 목록에 등록된 주소만 사용 가능합니다.
  - `secondary_address` string, nullable — 2차 출금 주소. 일부 디지털 자산의 경우 입출금 주소가 Destination Tag, Memo, 또는 Message와 같은 2차 주소를 포함합니다. 디지털 자산을 수신할 거래소의 수신 주소(입금 주소) 정보에 2차 주소가 포함되어있다면 이 필드를 반드시 포함하여 출금을 요청해야 합니다.
  - `transaction_type` 'default' | 'internal' — 출금 유형. 사용 가능한 값은 다음과 같습니다. * `default`: 일반출금 * `internal`: 바로출금

## Response `201`

Object of digital asset withdrawal

- object
  - `type` string, required — 입출금 종류
  - `uuid` string, required — 출금의 유일 식별자
  - `currency` string, required — 조회하고자 하는 통화 코드
  - `net_type` string, required — 출금 네트워크 유형. 업비트에서 사용하는 블록체인 네트워크 구분자입니다. 출금 요청 시 사용되는 `net_type` 파라미터는 이 필드와 같은 값을 사용해야 합니다. [예시] "ETH", "TRX", "SOL"
  - `txid` string, nullable, required — 트랜잭션 ID
  - `state` 'WAITING' | 'PROCESSING' | 'DONE' | 'FAILED' | 'CANCELLED' | 'REJECTED', required — 출금 처리 상태 - `WAITING`: 대기 중 - `PROCESSING`: 처리 중 - `DONE`: 완료 - `FAILED`: 실패 - `CANCELLED`: 취소됨 - `REJECTED`: 거절됨
  - `created_at` string, required — 출금 생성 시간
  - `done_at` string, nullable — 출금 완료 시간. 출금이 완료되지 않은 경우 null로 반환됩니다
  - `amount` string, required — 출금하고자 하는 자산의 수량
  - `fee` string, required — 출금 수수료
  - `transaction_type` 'default' | 'internal', required — 출금 유형. 사용 가능한 값은 다음과 같습니다. * `default`: 일반출금 * `internal`: 바로출금
  - `is_cancelable` boolean, required — 출금 취소 가능 여부

## Other responses

- `400` — error object
- `403` — Forbidden

---

[API](https://skmtc.net/upbit/apis/quotation-api.md) · [All operations](https://skmtc.net/upbit/apis/quotation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upbit/quotation-api/versions/b8bd8b9ed3b5/schema)