---
title: "출금 목록 조회"
method: GET
path: "/withdraws"
tags: ["출금(Withdrawal)"]
---

# 출금 목록 조회

`GET /withdraws`

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

## Query parameters

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

## Response `200`

List of withdrawals

- object[]
  - `type` string, required — 입출금 종류
  - `uuid` string, required — 출금의 유일 식별자
  - `currency` string, required — 조회하고자 하는 통화 코드
  - `net_type` string — 출금 네트워크 유형. 업비트에서 사용하는 블록체인 네트워크 구분자입니다. 원화(KRW) 출금의 경우 null로 반환됩니다. [예시] "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
- `401` — error object

---

[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)