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

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

`GET /pockets/transfers`

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

## Query parameters

- `direction` 'in' | 'out' | 'all'
- `states[]` 'submitted' | 'processing' | 'done' | 'failed'
- `uuids[]` string
- `identifiers[]` string
- `start_time` string
- `end_time` string
- `currency` string
- `limit` string
- `order_by` string

## Response `200`

- object
  - `uuid` string, required — 자산 이전 요청 UUID
  - `identifier` string — 자산 이전 요청 시 클라이언트가 지정한 식별자. identifier가 없는 경우 null이 반환됩니다.
  - `from` string — 자산이 빠져나간 포켓의 UUID
  - `to` string — 자산이 들어간 포켓의 UUID
  - `state` 'submitted' | 'processing' | 'done' | 'failed' — 자산 이전 요청 상태. - `submitted` : 접수됨 - `processing` : 처리 중 - `done` : 완료 - `failed` : 실패
  - `currency` string — 이전된 자산 코드 예: KRW, BTC, ETH 등
  - `amount` string — 이전된 자산 수량.
  - `created_at` string — 요청 생성 시간.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found

---

[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/versions/b8bd8b9ed3b5/schema)