API 키란?
API 키는 KimpBee가 사용자를 대신하여 거래소에 접속할 수 있게 해주는 디지털 인증 수단입니다. API 키를 통해 KimpBee가 시세 조회, 주문 실행, 잔고 확인 등을 자동으로 수행합니다.
API 키는 KimpBee가 설치된 내 컴퓨터에만 저장됩니다. 서버로 전송되지 않으며, 하드웨어 기반 암호화로 보호됩니다.
발급 절차
업비트 Open API 관리 페이지 접속
- 업비트에 로그인합니다
- 마이페이지 → "Open API 관리"로 이동합니다
- 또는 상단 메뉴에서 "고객센터" → "Open API 안내"를 통해 접근할 수 있습니다
API 키 신규 발급
- "Open API Key 발급" 버튼을 클릭합니다
- 2단계 인증(카카오페이 또는 Google OTP)을 완료합니다
권한 설정
API 키에 부여할 권한을 선택합니다. KimpBee에 필요한 권한은 다음과 같습니다.
| 권한 | 필요 여부 | 용도 | |------|----------|------| | 자산 조회 | ✅ 필수 | 잔고 확인 | | 주문 조회 | ✅ 필수 | 주문 상태 확인 | | 주문하기 | ✅ 필수 | 매수/매도 주문 실행 | | 출금하기 | ✅ 필수 | 거래소 간 코인 이체 (청산 방어, 잔고 리밸런싱) |
출금 권한은 거래소 간 코인 이체에 필요합니다. KimpBee는 선물 거래소의 청산 방어나 현물·선물 거래소 간 코인 잔고 균형 유지를 위해 자동으로 코인을 이체할 수 있습니다.
보안이 걱정된다면, 업비트의 출금 주소 화이트리스트 기능을 활용하세요. 사전에 등록된 주소로만 출금이 가능하도록 설정하면, API 키가 유출되더라도 등록되지 않은 주소로는 출금할 수 없어 자산을 안전하게 보호할 수 있습니다.
IP 주소 설정
- 특정 IP에서만 실행: 보안을 위해 KimpBee를 실행하는 PC의 IP 주소를 등록합니다
- 내 IP 확인 방법: 검색엔진에서 "내 IP 주소" 검색
- 고정 IP가 아닌 경우 IP가 변경될 때마다 업데이트해야 합니다
유동 IP 환경이라면 "모든 IP 허용"을 선택할 수 있지만, 보안 측면에서 특정 IP 등록을 권장합니다.
API 키 확인 및 저장
- 발급이 완료되면 Access Key와 Secret Key가 표시됩니다
- Secret Key는 이 시점에만 확인 가능합니다. 반드시 안전한 곳에 복사해두세요
- 분실 시 키를 삭제하고 재발급해야 합니다
KimpBee에 등록하기
발급받은 API 키를 KimpBee에 등록합니다.
KimpBee API 키 설정
- KimpBee 앱 실행 → 좌측 메뉴에서 "API 키" 선택
- 업비트 섹션에 다음을 입력합니다:
- Access Key: 발급받은 Access Key
- Secret Key: 발급받은 Secret Key
- "연결 테스트" 버튼으로 정상 연동을 확인합니다
API 키는 보안을 위해 3개월에 한 번씩 삭제 후 재발급하는 것을 권장합니다. 기존 키를 삭제하고 새 키를 발급받아 KimpBee에 다시 등록하세요.
문제 해결
| 증상 | 해결 방법 | |------|----------| | "인증 실패" 오류 | Access Key 또는 Secret Key를 다시 확인하세요 | | "IP 제한" 오류 | 현재 PC의 IP가 허용 목록에 있는지 확인하세요 | | "권한 부족" 오류 | API 키의 권한 설정에서 자산조회/주문조회/주문하기가 모두 체크되어 있는지 확인하세요 |