포켓 정보 조회

사용자가 보유한 메인 포켓 및 사용자 생성 포켓의 UUID와 이름 정보를 조회하는 API입니다. 조회된 포켓 UUID는 포켓별 API Key 목록 조회, 서브포켓 잔고 조회, 메인포켓·서브포켓 간 자산 이전 및 자산 이전 내역 조회 등의 기능을 수행하기 위한 식별자로 사용됩니다.


포켓 정보 활용 구조

flowchart LR
    A[포켓 정보 조회<br/>GET /v1/pockets]

    A --> B[메인포켓 UUID / 이름]
    A --> C[사용자 생성 포켓 UUID / 이름]

    B --> D[포켓별 API Key 목록 조회<br/>GET /v1/pockets/api_keys]
    B --> E[서브포켓 잔고 조회<br/>GET /v1/pockets/asset]
    B --> F[메인포켓 자산 이전<br/>POST /v1/pockets/transfers]
    B --> G[메인포켓 자산 이전 목록 조회<br/>GET /v1/pockets/transfers]

    C --> H[서브포켓 자산 이전<br/>POST /v1/pockets/transfers]
    C --> I[서브포켓 자산 이전 목록 조회<br/>GET /v1/pockets/transfers]

    style A fill:#eef,stroke:#446
    style B fill:#efe,stroke:#4a4
    style C fill:#efe,stroke:#4a4


Rate Limit
초당 최대 30회 호출할 수 있습니다. 계정단위로 측정되며 [Exchange 기본 그룹] 내에서 요청 가능 횟수를 공유합니다.

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


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.