빗썸 API 키 개요
빗썸은 API 1.0과 API 2.0 두 가지 버전이 있습니다. 현재 KimpBee는 API 2.0을 사용합니다.
빗썸 API 2.0 키는 2가지 정보로 구성됩니다.
| 항목 | 설명 | |------|------| | Access Key | 공개 키 (API Key) | | Secret Key | 비밀 키 (JWT 서명용) |
KimpBee는 API 2.0 키만 인식합니다. 기존에 API 1.0 키를 등록해 두셨다면 빗썸에서 API 2.0 탭으로 새로 발급받아 다시 등록해야 합니다.
발급 절차
API 관리 페이지 접속
- 빗썸에 로그인합니다
- 마이페이지 → "API 관리"로 이동합니다
- API 2.0 탭을 선택합니다
API 키 발급 신청
- "API Key 발급" 버튼을 클릭합니다
- OTP 인증 또는 SMS 인증을 완료합니다
권한 설정
KimpBee에 필요한 권한을 설정합니다.
| 권한 | 필요 여부 | 용도 | |------|----------|------| | 자산 조회 | ✅ 필수 | 잔고 확인 | | 주문 조회 | ✅ 필수 | 주문 상태 확인 | | 주문하기 | ✅ 필수 | 매수/매도 주문 실행 | | 출금하기 | ✅ 권장 | 거래소 간 코인 이체 |
API 2.0에서는 모든 코인의 출금이 API로 가능합니다 (1.0의 BTC 전용 제한이 사라졌습니다). 단, 빗썸의 출금 주소 화이트리스트를 함께 설정하면 API 키가 유출되더라도 등록된 주소로만 출금이 가능하므로 자산을 안전하게 보호할 수 있습니다.
IP 주소 설정
- 보안을 위해 KimpBee를 실행하는 PC의 IP 주소를 등록합니다
- 내 IP 확인 방법: 검색엔진에서 "내 IP 주소" 검색
- 고정 IP가 아닌 경우 IP 변경 시 업데이트가 필요합니다
API 키 확인 및 저장
- 발급이 완료되면 Access Key와 Secret Key가 표시됩니다
- Secret Key는 이 시점에만 확인 가능합니다. 반드시 안전한 곳에 복사해두세요
- 분실 시 키를 삭제하고 재발급해야 합니다
KimpBee에 등록하기
KimpBee API 키 설정
- KimpBee 앱 실행 → 좌측 메뉴에서 "API 키" 선택
- 빗썸 섹션에 다음을 입력합니다:
- API Key: 발급받은 Access Key
- Secret Key: 발급받은 Secret Key
- "연결 테스트" 버튼으로 정상 연동을 확인합니다
API 키는 보안을 위해 3개월에 한 번씩 삭제 후 재발급하는 것을 권장합니다. 기존 키를 삭제하고 새 키를 발급받아 KimpBee에 다시 등록하세요.
문제 해결
| 증상 | 해결 방법 | |------|----------| | "인증 실패" / JWT 오류 | Access Key 또는 Secret Key를 다시 확인하세요. API 2.0 탭에서 발급한 키가 맞는지 확인하세요 | | "IP 제한" 오류 | 현재 PC의 IP가 허용 목록에 있는지 확인하세요 | | "권한 부족" 오류 | API 키의 권한 설정에서 필요한 항목이 모두 체크되어 있는지 확인하세요 | | 연결 테스트 실패 | API 1.0 키를 등록한 경우입니다. 빗썸에서 API 2.0 키를 새로 발급받아 다시 등록하세요 |