Upbit API 이용 준비
사용 목적 정의
Upbit API 사용 전, 사용 목적을 먼저 확인하세요.
사용 목적에 따라 API Key 필요 여부와 권한(Scope)이 달라집니다.
필요한 기능에 맞게 최소 권한만 설정하는 것을 권장합니다.
API Key는 Upbit PC Web의 Open API 관리 페이지에서 발급할 수 있습니다.
사용 목적별 권한 안내
| 사용 목적 | 메인포켓 (API Key) | 서브포켓 (API Key) | 필요 권한 | 비고 |
|---|---|---|---|---|
| 시세 및 마켓 데이터 조회 | 불필요 | 불필요 | Public API로 조회 가능 | |
| 과거 마켓 데이터 수집 | 불필요 | 불필요 | Historical Market Data 문서 참고 | |
| 메인 포켓 정보 조회 | 필요 | 필요 |
|
|
| 포켓 간 자산 이전 | 필요 | 필요 |
|
|
| 자산 조회 및 관리 | 필요 | 필요 | 자산조회 | 잔고 및 보유 자산 조회 |
| 주문 | 필요 | 필요 | 주문조회, 주문하기 | 주문 API 사용 |
| 입금 | 필요 | 미지원 | 입금조회, 입금하기 | 입금 및 조회 가능 |
| 출금 | 필요 | 미지원 | 출금조회, 출금하기 | 디지털 자산 출금 시 허용 주소 등록 필요 거래소 / 개인지갑 |
오류 해결권한 또는 출금허용주소가 사전에 설정되지 않은 경우 API 호출 시 오류가 발생할 수 있습니다.
- 401 Unauthorized(out_of_scope)
- API Key에 필요한 권한이 포함되어 있지 않은 경우 발생합니다. 필요한 권한 선택 후 새로 Key를 발급 받길 바랍니다.
- 400 Bad Request(withdraw_address_not_registered)
- 출금허용주소가 등록되지 않은 경우 발생합니다. 출금주소를 등록하시길 바랍니다.