---
title: "원화 출금 요청"
method: POST
path: "/v1/withdraws/krw"
tags: ["Exchange"]
---

# 원화 출금 요청

`POST /v1/withdraws/krw`

## Request

- Base URL: `https://api.upbit.com`
- URL: `https://api.upbit.com/v1/withdraws/krw`
- Auth: none declared

원화(KRW) 출금을 요청합니다.

## Request body

- object
  - `amount` string, decimal, required: 출금하고자 하는 원화 금액. 숫자 형식의 String으로 입력합니다.
  - `two_factor_type` 'kakao' | 'naver' | 'hana', required: 원화 입출금 시 사용할 2차 인증 수단. * `kakao`: 카카오 인증 * `naver`: 네이버 인증 * `hana`: 하나인증서 인증

## Response `201`

Object of KRW withdrawal

- WithdrawKrw
  - `type` string, required: 입출금 종류
  - `uuid` string, required: 출금의 유일 식별자
  - `currency` string, required: 조회하고자 하는 통화 코드
  - `net_type` string, nullable, required: 출금 네트워크 유형. 업비트에서 사용하는 블록체인 네트워크 구분자입니다. [예시] "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, decimal, required: 출금하고자 하는 자산의 수량
  - `fee` string, decimal, required: 출금 수수료
  - `transaction_type` 'default' | 'internal', required: 출금 유형. * `default`: 일반출금 * `internal`: 바로출금
  - `is_cancelable` boolean, nullable, required: 출금 취소 가능 여부

## Other responses

- `400`: error object

---

[API](https://skmtc.dev/upbit/apis/exchange-api.md) - [All operations](https://skmtc.dev/upbit/apis/exchange-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upbit/apis/exchange-api/revisions/150ea50e351c?raw)