UPupbit
Exchange

출금 목록 조회

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

get/v1/withdraws

Request

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

Query parameters

currencystring

조회하고자 하는 통화 코드. 미지정시 모든 통화 코드에 대해 조회됩니다.

Example:KRW
state'WAITING' | 'PROCESSING' | 'DONE' | 'FAILED' | 'CANCELLED' | 'REJECTED'

조회하고자 하는 출금 처리 상태.

  • WAITING: 대기중
  • PROCESSING: 진행중
  • DONE: 완료
  • FAILED: 실패
  • CANCELLED: 취소됨
  • REJECTED: 거절됨
uuids[]string[]

조회하고자 하는 유일식별자(UUID) 목록. 최대 100개의 UUID를 입력할 수 있습니다. uuids와 txids 파라미터는 동시에 사용할 수 없습니다.

[예시] uuids[]=uuid1&uuids[]=uuid2

[
  "9ca023a5-851b-4fec-9f0a-48cd83c2eaae"
]
txids[]string[]

조회하고자 하는 트랜잭션 ID 목록. 최대 100개의 txid를 입력할 수 있습니다. uuids와 txids 파라미터는 동시에 사용할 수 없습니다.

[예시] txids[]=txid1&txids[]=txid2

[
  "98c15999f0bdc4ae0e8a-ed35868bb0c204fe6ec29e4058a3451e-88636d1040f4baddf943274ce37cf9cc"
]
limitinteger

요청 개수(default: 100, max: 100)

Example:100
pageinteger

조회할 페이지 번호. 미지정시 기본값은 1입니다.

Example:1
order_by'asc' | 'desc'

결과 정렬 방식. "desc"(최신 순) 또는 "asc"(오래된 순). 기본값은 "desc"입니다.

Example:desc
fromstring

Pagination을 위한 조회 범위 지정용 커서. 응답에 포함된 "uuid" 값을 이 필드에 입력하여 해당 출금 시각 이후 "limit"개의 출금 이력을 이어서 조회할 수 있습니다.

tostring

Pagination을 위한 조회 범위 지정용 커서. 응답에 포함된 "uuid" 값을 이 필드에 입력하여 해당 출금 시각 이전 "limit"개의 출금 이력을 조회할 수 있습니다.

Response

List of withdrawals

typestring required

입출금 종류

uuidstring required

출금의 유일 식별자

currencystring required

조회하고자 하는 통화 코드

net_typestring nullable required

출금 네트워크 유형.

업비트에서 사용하는 블록체인 네트워크 구분자입니다.

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

txidstring nullable required

트랜잭션 ID

state'WAITING' | 'PROCESSING' | 'DONE' | 'FAILED' | 'CANCELLED' | 'REJECTED' required

출금 처리 상태

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

출금 생성 시간

done_atstring nullable

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

amountstring decimal required

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

feestring decimal required

출금 수수료

transaction_type'default' | 'internal' required

출금 유형.

  • default: 일반출금
  • internal: 바로출금
is_cancelableboolean nullable 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"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.