post
https://api.upbit.com/v1/pockets/universal_transfers
메인포켓 자산 이전 가능 범위
메인포켓의 API Key를 사용하여 다음과 같은 자산 이전을 요청할 수 있습니다. 조회하고자하는 포켓 UUID는 포켓 정보 조회 API를 통해 확인할 수 있습니다.
-
메인포켓 → 서브포켓 : 메인포켓의 자산을 서브포켓으로 이전
-
서브포켓 → 메인포켓 : 서브포켓의 자산을 메인포켓으로 이전
-
서브포켓 →서브포켓 : 서로 다른 서브포켓 간 자산 이전
flowchart LR
A[메인포켓] --> B[서브포켓]
B --> A
B --> C[다른 서브포켓]
메인포켓 자산 이전 흐름 예시
flowchart LR
A[포켓 정보 조회<br/>GET /v1/pockets]
--> B[포켓 UUID 확인]
B --> C[자산 이전 요청]
C --> D[from 포켓]
C --> E[to 포켓]
D --> F[자산 이전 처리]
E --> F
F --> G[submitted]
G --> H[processing]
H --> I[done 또는 failed]
유의사항
- 동일한 포켓 간 자산 이전은 지원하지 않습니다. (
from != to) - 자산 이전 요청에는 고유한
identifier를 사용할 수 있습니다. identifier는 성공 또는 실패 여부와 관계없이 한 번만 사용할 수 있으며, 이미 사용된 값은 재사용할 수 없습니다.identifier지정 시 허용규격은 1~64자 내의 문자, 숫자, 언더스코어(_), 점(.), 하이픈(-) 입니다.from을 지정하지 않으면 현재 요청에 사용한 API Key가 속한 포켓 UUID가 기본값으로 사용됩니다.
상태(State)
자산 이전 요청은 다음 상태 중 하나를 가집니다.
| 상태 | 설명 |
|---|---|
submitted | 요청 접수 |
processing | 처리 중 |
done | 처리 완료 |
failed | 처리 실패 |
Rate Limit
초당 최대 30회 호출할 수 있습니다. 계정단위로 측정되며 [Exchange 기본 그룹] 내에서 요청 가능 횟수를 공유합니다.
API Key Permission
인증이 필요한 API로, 메인포켓만 사용 가능합니다.
메인포켓 키발급 페이지에서 [포켓관리] 권한이 설정된 API Key를 사용해야 합니다.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.
메인포켓 키발급 페이지에서 [포켓관리] 권한이 설정된 API Key를 사용해야 합니다.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.
