---
title: "서브포켓 자산 이전 목록 조회"
method: GET
path: "/v1/pockets/transfers"
tags: ["Exchange"]
---

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

`GET /v1/pockets/transfers`

## Request

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

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

## Query parameters

- `direction` 'in' | 'out' | 'all': 이체 방향.
- `states[]` PocketTransferState[]: 자산 이전 요청 상태. 지정한 상태의 이전 내역만 조회합니다. 미지정 시 모든 상태의 내역을 반환합니다. [예시] states[]=done&states[]=failed
- `uuids[]` string[]: 자산 이전 요청을 식별하는 UUID 목록. 지정한 UUID에 해당하는 자산 이전 내역만 반환합니다. [예시] uuids[]=uuid1&uuids[]=uuid2 제한사항: 최대 20개까지 조회 가능
- `identifiers[]` string[]: 클라이언트가 요청 시 지정한 식별자 목록. [예시] identifiers[]=id1&identifiers[]=id2 제한사항: 최대 20개까지 조회 가능
- `start_time` string: 조회 기간의 시작 시각. 지정한 시각부터 end_time까지 생성된 내역을 조회합니다. 허용 규격: ISO 8601(타임존 포함) 또는 밀리초 타임스탬프
- `end_time` string: 조회 기간의 종료 시각. start_time부터 지정한 시각까지 생성된 내역을 조회합니다. 기본값: 현재 시각 제한 사항: 최대 조회 범위 7일 허용 규격: ISO 8601(타임존 포함) 또는 밀리초 타임스탬프
- `currency` string: 조회하고자 하는 자산의 코드
- `limit` integer: 요청 개수(기본값 20, 최대 100)
- `order_by` 'asc' | 'desc': 결과 정렬 방식. asc(오래된 순), desc(최신순)

## Response `200`

List of pocket transfers

- PocketTransfer[]
  - `uuid` string, required: 자산 이전 요청을 식별하는 UUID
  - `identifier` string, nullable, required: 자산 이전 요청 시 클라이언트가 지정한 식별자. 지정하지 않을 경우 null을 반환합니다.
  - `from` string, required: 자산을 보낸 포켓의 UUID
  - `to` string, required: 자산을 받은 포켓의 UUID
  - `state` 'submitted' | 'processing' | 'done' | 'failed', required: 자산 이전 요청 상태. * `submitted`: 접수됨 * `processing`: 처리 중 * `done`: 완료 * `failed`: 실패
  - `currency` string, required: 이전된 자산 코드. [예시] KRW, BTC, ETH
  - `amount` string, decimal, required: 이전된 자산 수량
  - `created_at` string, required: 요청 생성 시각

## Other responses

- `400`: error object
- `403`: error object
- `404`: 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)