---
title: "서브포켓 자산 이전"
method: POST
path: "/pockets/transfers"
---

# 서브포켓 자산 이전

`POST /pockets/transfers`

서브포켓의 API Key 권한을 사용하여 포켓 간(서브포켓 ↔ 서브포켓 등) 자산 이전을 요청하는 API입니다.

## Request body

- object
  - `to` string, required — 받는 포켓의 UUID. 미지정 시 메인포켓으로 자산이 이전됩니다.
  - `currency` string, required — 이전하고자 하는 자산 코드 예: KRW, BTC, ETH 등
  - `amount` string, required — 이전하고자 하는 자산 수량.
  - `identifier` string — 자산 이전 요청 시 클라이언트가 지정한 식별자. 지정하지 않을 경우 `null`을 반환합니다. 허용규격 : 1~64자 내의 문자, 숫자, 언더스코어(_), 점(.), 하이픈(-)

## Response `201`

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

## 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)