Sign in

v1

latestOpenAPI 3.0.12026-07-24510443.1 KB
입금(Deposit)

입금 목록 조회

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

get/deposits

Query parameters

currencystring

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

Example:KRW
state'PROCESSING' | 'ACCEPTED' | 'CANCELLED' | 'REJECTED' | 'TRAVEL_RULE_SUSPECTED' | 'REFUNDING' | 'REFUNDED'

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

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

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

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

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

[
  "9ca023a5-851b-4fec-9f0a-48cd83c2eaae"
]
txids[]string[]

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

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

[
  "98c15999f0bdc4ae0e8a-ed35868bb0c204fe6ec29e4058a3451e-88636d1040f4baddf943274ce37cf9cc"
]
limitinteger

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

Example:100
pageinteger

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

Example:1
order_by'asc' | 'desc'

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

Example:desc
fromstring

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

tostring

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

Response

List of deposits

typestring

입금 종류

uuidstring

입금의 유일식별자(UUID)

currencystring

조회하고자 하는 통화 코드

net_typestring nullable

입금 네트워크 유형. 업비트에서 사용하는 블록체인 네트워크 구분자입니다.

[예시] ETH, TRX, SOL

txidstring

입금 트랜잭션 ID.

state'PROCESSING' | 'ACCEPTED' | 'CANCELLED' | 'REJECTED' | 'TRAVEL_RULE_SUSPECTED' | 'REFUNDING' | 'REFUNDED'

입금 처리 상태

  • PROCESSING: 입금 진행 중 (디지털 자산만 해당)
  • ACCEPTED: 완료
  • CANCELLED: 취소됨
  • REJECTED: 거절됨
  • TRAVEL_RULE_SUSPECTED: 트래블룰 추가 인증 대기중 (디지털 자산만 해당)
  • REFUNDING: 반환 절차 중
  • REFUNDED: 반환됨 (디지털 자산만 해당)
created_atstring

입금 요청 시각 (KST)

[형식] yyyy-MM-ddTHH:mm:ss+09:00

done_atstring nullable

입금 완료 시각 (KST)

[형식] yyyy-MM-ddTHH:mm:ss+09:00

amountstring

입금하고자 하는 원화의 금액.

feestring

입금 수수료

transaction_type'default' | 'internal'

입금 유형

  • default: 일반 입금
  • internal: 바로 입금 (업비트 계정간 입금)

Example response

[
  {
    "type": "deposit",
    "uuid": "5b871d34-fe38-4025-8f5c-9b22028f85d3",
    "currency": "BTC",
    "net_type": "BTC",
    "txid": "5BC9E3CD3EFCAB866060C5A61A98E6079B4A49BCCFCBF7D220F903F67D1C76C4",
    "state": "ACCEPTED",
    "created_at": "2024-01-01T00:00:00",
    "done_at": "2024-01-01T00:00:00",
    "amount": "10000",
    "transaction_type": "default"
  }
]