메인포켓 자산 이전

메인포켓 자산 이전 가능 범위

메인포켓의 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 관리 메뉴에서 권한 설정을 확인해주세요.


Body Params
string
Defaults to 사용한 키의 포켓 uuid
string
required
string
required
string
required
string
Responses

Language
LoadingLoading…
Response
Choose an example:
application/json
※ This English version is a translation of the original Korean version of the Upbit Developer Center, generated using a third-party tool. In the event of any discrepancies, the Korean version shall take precedence.