---
title: "출금 목록 조회"
method: GET
path: "/v1/withdraws"
tags: ["Exchange"]
---

# 출금 목록 조회

`GET /v1/withdraws`

## Request

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

최신 출금 목록을 조회합니다.

## Query parameters

- `currency` string: 조회하고자 하는 통화 코드. 미지정시 모든 통화 코드에 대해 조회됩니다.
- `state` 'WAITING' | 'PROCESSING' | 'DONE' | 'FAILED' | 'CANCELLED' | 'REJECTED': 조회하고자 하는 출금 처리 상태. * `WAITING`: 대기중 * `PROCESSING`: 진행중 * `DONE`: 완료 * `FAILED`: 실패 * `CANCELLED`: 취소됨 * `REJECTED`: 거절됨
- `uuids[]` string[]: 조회하고자 하는 유일식별자(UUID) 목록. 최대 100개의 UUID를 입력할 수 있습니다. uuids와 txids 파라미터는 동시에 사용할 수 없습니다. [예시] uuids[]=uuid1&uuids[]=uuid2
- `txids[]` string[]: 조회하고자 하는 트랜잭션 ID 목록. 최대 100개의 txid를 입력할 수 있습니다. uuids와 txids 파라미터는 동시에 사용할 수 없습니다. [예시] txids[]=txid1&txids[]=txid2
- `limit` integer: 요청 개수(default: 100, max: 100)
- `page` integer: 조회할 페이지 번호. 미지정시 기본값은 1입니다.
- `order_by` 'asc' | 'desc': 결과 정렬 방식. "desc"(최신 순) 또는 "asc"(오래된 순). 기본값은 "desc"입니다.
- `from` string: Pagination을 위한 조회 범위 지정용 커서. 응답에 포함된 "uuid" 값을 이 필드에 입력하여 해당 출금 시각 이후 "limit"개의 출금 이력을 이어서 조회할 수 있습니다.
- `to` string: Pagination을 위한 조회 범위 지정용 커서. 응답에 포함된 "uuid" 값을 이 필드에 입력하여 해당 출금 시각 이전 "limit"개의 출금 이력을 조회할 수 있습니다.

## Response `200`

List of withdrawals

- Withdraw[]
  - `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
- `401`: 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)