---
title: "입금 목록 조회"
method: GET
path: "/v1/deposits"
tags: ["Exchange"]
---

# 입금 목록 조회

`GET /v1/deposits`

## Request

- Base URL: `https://api.upbit.com`
- URL: `https://api.upbit.com/v1/deposits`
- Auth: none declared

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

## Query parameters

- `currency` string: 조회하고자 하는 통화 코드. 미입력시 최신 입금 내역이 조회됩니다.
- `state` 'PROCESSING' | 'ACCEPTED' | 'CANCELLED' | 'REJECTED' | 'TRAVEL_RULE_SUSPECTED' | 'REFUNDING' | 'REFUNDED': 조회하고자 하는 입금 처리 상태. * `PROCESSING`: 진행중 * `ACCEPTED`: 완료 * `CANCELLED`: 취소됨 * `REJECTED`: 거절됨 * `TRAVEL_RULE_SUSPECTED`: 트래블룰 추가 인증 대기중 * `REFUNDING`: 반환 절차 진행중 * `REFUNDED`: 반환 완료
- `uuids[]` string[]: 조회하고자 하는 유일식별자(UUID) 목록. [예시] uuids[]=uuid1&uuids[]=uuid2
- `txids[]` string[]: 조회하고자 하는 트랜잭션 ID 목록. [예시] txids[]=txid1&txids[]=txid2
- `limit` integer: 요청 개수(default: 100, max: 100)
- `page` integer: 조회할 페이지 번호. 미지정시 기본값은 1입니다.
- `order_by` 'asc' | 'desc': 결과 정렬 방식. "desc"(최신 순) 또는 "asc"(오래된 순). 기본값은 "desc"입니다.
- `from` string: Pagination을 위한 조회 범위 지정용 커서. 응답에 포함된 "uuid" 값을 이 필드에 입력하여 해당 입금 시각 이후 "limit"개의 입금 이력을 이어서 조회할 수 있습니다.
- `to` string: Pagination을 위한 조회 범위 지정용 커서. 응답에 포함된 "uuid" 값을 이 필드에 입력하여 해당 입금 시각 이전 "limit"개의 입금 이력을 조회할 수 있습니다.

## Response `200`

List of deposits

- Deposit[]
  - `type` string, required: 입금 종류
  - `uuid` string, required: 입금의 유일식별자(UUID)
  - `currency` string, required: 입금하고자 하는 통화 코드
  - `net_type` string, nullable: 입금 네트워크 유형. 업비트에서 사용하는 블록체인 네트워크 구분자입니다. 원화(KRW) 입금의 경우 null로 반환됩니다. [예시] ETH, TRX, SOL
  - `txid` string, required: 입금 트랜잭션 ID.
  - `state` 'PROCESSING' | 'ACCEPTED' | 'CANCELLED' | 'REJECTED' | 'TRAVEL_RULE_SUSPECTED' | 'REFUNDING' | 'REFUNDED', required: 입금 처리 상태 - `PROCESSING`: 입금 진행 중 - `ACCEPTED`: 완료 - `CANCELLED`: 취소됨 - `REJECTED`: 거절됨 - `TRAVEL_RULE_SUSPECTED`: 트래블룰 추가 인증 대기중 - `REFUNDING`: 반환 절차 중 - `REFUNDED`: 반환됨
  - `created_at` string, required: 입금 요청 시각 (KST) [형식] yyyy-MM-ddTHH:mm:ss+09:00
  - `done_at` string, nullable, required: 입금 완료 시각 (KST) [형식] yyyy-MM-ddTHH:mm:ss+09:00
  - `amount` string, decimal, required: 입금하고자 하는 원화의 금액.
  - `fee` string, decimal, required: 입금 수수료
  - `transaction_type` 'default' | 'internal', required: 입금 유형 - `default`: 일반 입금 - `internal`: 바로 입금 (업비트 계정간 입금)

## Other responses

- `400`: error object
- `401`: error object

---

[API](https://skmtc.dev/upbit/apis/exchange-api.md) - [All operations](https://skmtc.dev/upbit/apis/exchange-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upbit/apis/exchange-api/revisions/150ea50e351c?raw)