입금 목록 조회

get

https://api.upbit.com/v1/deposits

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

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

Revision History

반영 버전	반영 일자	변경 사항
-	2023-05-22	네트워크 타입(net_type) 필드 추가
-	2020-05-29	`transaction_type` 필드 추가
-	2019-07-04	`stateuuidtxid` 파라미터 신규 지원

Rate Limit

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

API Key Permission

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

Query Params

currency

string

조회하고자 하는 통화 코드.
통화 코드로 조회 대상을 한정하기 위한 필터 파라미터입니다.
미입력시 최신 입금 내역이 조회됩니다.

state

string

enum

조회하고자 하는 입금 처리 상태.
입금 처리 상태로 조회 대상을 한정하기 위한 필터 파라미터입니다. 지정한 상태의 입금 정보만 응답으로 반환됩니다.

사용 가능한 값은 다음과 같습니다.

PROCESSING: 진행중
ACCEPTED: 완료
CANCELLED: 취소됨
REJECTED: 거절됨
TRAVEL_RULE_SUSPECTED: 트래블룰 추가 인증 대기중
REFUNDING: 반환 절차 진행중
REFUNDED: 반환 완료

Allowed:

uuids[]

array of strings

조회하고자 하는 유일식별자(UUID) 목록.
지정한 UUID에 해당하는 입출금 정보만 반환됩니다.

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

uuids[]

txids[]

array of strings

조회하고자 하는 트랜잭션 ID 목록.
지정한 txid에 해당하는 입출금 정보만 반환됩니다.

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

txids[]

limit

integer

Defaults to 100

요청 개수(default: 100, max: 100)
요청 당 조회할 주문 개수를 지정합니다. 한번에 최대 100개의 항목을 조회할 수 있으며, 미지정시 기본값은 100입니다.

page

integer

Defaults to 1

조회할 페이지 번호.
Pagination을 위한 파라미터로, 조회하고자 하는 페이지를 지정할 수 있습니다. 미지정시 기본값은 1입니다.

order_by

string

enum

Defaults to desc

결과 정렬 방식.
주문 생성 시각을 기준으로 설정한 방식에 따라 정렬된 주문 목록이 반환됩니다. 사용 가능한 값은 “desc”(내림차순, 최신 주문 순) 또는 “asc”(오름차순, 오래된 주문 순)입니다. 기본값은 “desc”입니다.

Allowed:

from

string

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

string

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

Responses

두나무 주식회사

서울특별시 서초구 강남대로 369, 15층

대표 오경석

사업자등록번호 119-86-54968

가상자산사업자 등록번호 2021 - 01

두나무 주식회사

서울특별시 서초구 강남대로 369, 15층

대표 오경석

사업자등록번호 119-86-54968

가상자산사업자 등록번호 2021 - 01

200List of deposits

400error object

401error object