---
title: "개별 입금 조회"
method: GET
path: "/deposit"
tags: ["입금(Deposit)"]
---

# 개별 입금 조회

`GET /deposit`

최신 입금 이력을 조회합니다. 특정 입금 정보를 조회하고자 하는 경우 입금의 UUID 또는 트랜잭션 ID(TXID), 통화 코드로 지정할 수 있습니다.

## Query parameters

- `currency` string — 조회하고자 하는 통화 코드. 통화 코드로 조회 대상을 한정하기 위한 필터 파라미터입니다.
- `uuid` string — 조회하고자 하는 입금의 유일식별자(UUID) uuid와 txid를 모두 입력하지 않는 경우 최신 입금 정보가 반환됩니다.
- `txid` string — 조회하고자 하는 입금의 트랜잭션 ID uuid와 txid를 모두 입력하지 않는 경우 최신 입금 정보가 반환됩니다.

## Response `200`

Object of deposit

- object
  - `type` string, required — 입금 종류
  - `uuid` string, required — 입금의 유일식별자(UUID)
  - `currency` string, required — 조회하고자 하는 통화 코드
  - `net_type` string, nullable, required — 입금 네트워크 유형. 업비트에서 사용하는 블록체인 네트워크 구분자입니다. [예시] 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, required — 입금하고자 하는 원화의 금액.
  - `fee` string, required — 입금 수수료
  - `transaction_type` 'default' | 'internal', required — 입금 유형 - `default`: 일반 입금 - `internal`: 바로 입금 (업비트 계정간 입금)

## Other responses

- `400` — error object
- `401` — error object
- `404` — error object

---

[API](https://skmtc.net/upbit/apis/quotation-api.md) · [All operations](https://skmtc.net/upbit/apis/quotation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upbit/quotation-api/revisions/b8bd8b9ed3b5/schema)