입금 목록 조회

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

조회 조건을 설정하여 해당 조건을 만족하는 입금 목록만 조회할 수 있습니다. 통화, 입금 진행 상태, 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

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

  • PROCESSING: 진행중
  • ACCEPTED: 완료
  • CANCELLED: 취소됨
  • REJECTED: 거절됨
  • TRAVEL_RULE_SUSPECTED: 트래블룰 추가 인증 대기중
  • REFUNDING: 반환 절차 진행중
  • REFUNDED: 반환 완료
Allowed:
uuids[]
array of strings

조회하고자 하는 유일식별자(UUID) 목록.

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

uuids[]
txids[]
array of strings

조회하고자 하는 트랜잭션 ID 목록.

[예시] 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.