출금 목록 조회

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

조회 조건을 설정하여 해당 조건을 만족하는 출금 목록만 조회할 수 있습니다. 통화, 출금 진행 상태, UUID 목록 또는 TXID 목록을 필터 파라미터로 사용할 수 있습니다. 조건을 별도로 지정하지 않는 경우 최근 100개 출금 이력이 반환됩니다.

Rate Limit

초당 최대 30회 호출할 수 있습니다. 포켓 단위로 측정되며 [Exchange 기본 그룹] 내에서 요청 가능 횟수를 공유합니다. Rate Limit은 요청 처리량을 보장하는 기준이 아니며, 트래픽 상황이나 서비스 안정성 확보 필요에 따라 제한 또는 조정될 수 있습니다.


API Key Permission
인증이 필요한 API로, [출금조회] 권한이 설정된 API Key를 사용해야 합니다.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.

Query Params
string

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

string
enum

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

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

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

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

uuids[]
txids[]
array of strings

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

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

txids[]
integer
Defaults to 100

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

integer
Defaults to 1

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

string
enum
Defaults to desc

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

Allowed:
string

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

string

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

Responses

Language
LoadingLoading…
Response
Choose an example:
application/json
※ This English version is a translation of the original Korean version of the Upbit Developer Center, generated using a third-party tool. In the event of any discrepancies, the Korean version shall take precedence.