메인포켓 자산 이전

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

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

메인포켓의 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 기본 그룹] 내에서 요청 가능 횟수를 공유합니다. Rate Limit은 요청 처리량을 보장하는 기준이 아니며, 트래픽 상황이나 서비스 안정성 확보 필요에 따라 제한 또는 조정될 수 있습니다.

API Key Permission
인증이 필요한 API로, 메인포켓만 사용 가능합니다.
메인포켓 키발급 페이지에서 [포켓관리] 권한이 설정된 API Key를 사용해야 합니다.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.

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

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

string
required

받는 포켓의 UUID

string
required

이전하고자 하는 자산 코드
예: KRW, BTC, ETH 등

string
required

이전하고자 하는 자산 수량.

string

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

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

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.