Exchange

서브포켓 자산 이전 목록 조회

서브포켓의 API Key 권한을 사용하여 해당 서브포켓에서 발생한 포켓 간 자산 이전 내역 목록을 조회하는 API입니다.

get/v1/pockets/transfers

Request

Base URL
https://api.upbit.com
URL
https://api.upbit.com/v1/pockets/transfers
Auth
none declared

Query parameters

direction'in' | 'out' | 'all'

이체 방향.

Example:out

states[]PocketTransferState[]

자산 이전 요청 상태. 지정한 상태의 이전 내역만 조회합니다. 미지정 시 모든 상태의 내역을 반환합니다.

[예시] states[]=done&states[]=failed

[
  "processing"
]

uuids[]string[]

자산 이전 요청을 식별하는 UUID 목록. 지정한 UUID에 해당하는 자산 이전 내역만 반환합니다.

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

제한사항: 최대 20개까지 조회 가능

identifiers[]string[]

클라이언트가 요청 시 지정한 식별자 목록.

[예시] identifiers[]=id1&identifiers[]=id2

제한사항: 최대 20개까지 조회 가능

start_timestring

조회 기간의 시작 시각. 지정한 시각부터 end_time까지 생성된 내역을 조회합니다.

허용 규격: ISO 8601(타임존 포함) 또는 밀리초 타임스탬프

end_timestring

조회 기간의 종료 시각. start_time부터 지정한 시각까지 생성된 내역을 조회합니다.

기본값: 현재 시각 제한 사항: 최대 조회 범위 7일 허용 규격: ISO 8601(타임존 포함) 또는 밀리초 타임스탬프

currencystring

조회하고자 하는 자산의 코드

Example:XRP

limitinteger

요청 개수(기본값 20, 최대 100)

Example:2

order_by'asc' | 'desc'

결과 정렬 방식. asc(오래된 순), desc(최신순)

Example:desc

Response

List of pocket transfers

uuidstring required

자산 이전 요청을 식별하는 UUID

identifierstring nullable required

자산 이전 요청 시 클라이언트가 지정한 식별자. 지정하지 않을 경우 null을 반환합니다.

fromstring required

자산을 보낸 포켓의 UUID

tostring required

자산을 받은 포켓의 UUID

state'submitted' | 'processing' | 'done' | 'failed' required

자산 이전 요청 상태.

submitted: 접수됨
processing: 처리 중
done: 완료
failed: 실패

currencystring required

이전된 자산 코드.

[예시] KRW, BTC, ETH

amountstring decimal required

이전된 자산 수량

created_atstring required

요청 생성 시각

Example response

[
  {
    "uuid": "9ca023a5-851b-4fec-9f0a-48cd83c2eaae",
    "identifier": "unique_transfer_id_20260531_01",
    "from": "9ca023a5-851b-4fec-9f0a-48cd83c2eaae",
    "to": "9ca023a5-851b-4fec-9f0a-48cd83c2eaae",
    "state": "processing",
    "currency": "XRP",
    "amount": "10.00",
    "created_at": "2026-05-28T15:17:51+09:00"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.