Exchange

메인포켓 자산 이전

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

post/v1/pockets/universal_transfers

Request

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

Request body

fromstring

보내는 포켓의 UUID. 미입력 시 현재 요청에 사용한 API Key 소속 포켓이 기본값으로 지정됩니다.

tostring required

받는 포켓의 UUID

currencystring required

이전하고자 하는 자산 코드.

[예시] KRW, BTC, ETH

amountstring decimal required

이전하고자 하는 자산 수량

identifierstring

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

허용규격: 1~64자 내의 문자, 숫자, 언더스코어(_), 점(.), 하이픈(-)

Example request

{
  "from": "9ca023a5-851b-4fec-9f0a-48cd83c2eaae",
  "to": "9ca023a5-851b-4fec-9f0a-48cd83c2eaae",
  "currency": "XRP",
  "amount": "10.00",
  "identifier": "unique_transfer_id_20260531_01"
}

Response

Created pocket transfer

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.