get
https://api.upbit.com/v1/pockets
사용자가 보유한 메인 포켓 및 사용자 생성 포켓의 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 관리 메뉴에서 권한 설정을 확인해주세요.
메인포켓 키발급 페이지에서 [포켓관리] 권한이 설정된 API Key를 사용해야 합니다.
권한 오류(out_of_scope) 오류가 발생한다면, API Key 관리 메뉴에서 권한 설정을 확인해주세요.
