---
title: "메인포켓 자산 이전"
method: POST
path: "/v1/pockets/universal_transfers"
tags: ["Exchange"]
---

# 메인포켓 자산 이전

`POST /v1/pockets/universal_transfers`

## Request

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

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

## Request body

- object
  - `from` string: 보내는 포켓의 UUID. 미입력 시 현재 요청에 사용한 API Key 소속 포켓이 기본값으로 지정됩니다.
  - `to` string, required: 받는 포켓의 UUID
  - `currency` string, required: 이전하고자 하는 자산 코드. [예시] KRW, BTC, ETH
  - `amount` string, decimal, required: 이전하고자 하는 자산 수량
  - `identifier` string: 자산 이전 요청 시 클라이언트가 지정한 식별자. 지정하지 않을 경우 null을 반환합니다. 허용규격: 1~64자 내의 문자, 숫자, 언더스코어(_), 점(.), 하이픈(-)

## Response `201`

Created pocket transfer

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