비트겟 API 키 개요
비트겟 API 키는 3가지 정보로 구성됩니다.
| 항목 | 설명 | |------|------| | API Key | 공개 키 (Access Key) | | Secret Key | 비밀 키 (서명용) | | Passphrase | 추가 보안 비밀번호 (비트겟 고유) |
비트겟은 업비트와 달리 Passphrase라는 추가 보안 요소가 있습니다. 이 값도 KimpBee에 등록해야 합니다.
발급 절차
API 관리 페이지 접속
- 비트겟에 로그인합니다
- 우측 상단 프로필 아이콘 → "API 관리"를 클릭합니다
- 또는 "계정 보안" → "API 관리"에서 접근할 수 있습니다
새 API 키 생성
- "API 키 생성" 버튼을 클릭합니다
- Google OTP 또는 이메일 인증을 완료합니다
API 키 기본 정보 입력
- 메모(Note): 용도를 기록합니다 (예: "KimpBee")
- Passphrase: 직접 설정하는 추가 비밀번호입니다
- 영문 + 숫자 조합으로 설정합니다
- 이 값을 반드시 기억하세요. API 키 사용 시 매번 필요합니다
권한 설정
KimpBee에 필요한 권한을 설정합니다.
| 권한 | 필요 여부 | 용도 | |------|----------|------| | 읽기 (Read) | ✅ 필수 | 잔고, 포지션 조회 | | 거래 (Trade) | ✅ 필수 | 선물 주문 실행 | | 출금 (Withdraw) | ✅ 필수 | 거래소 간 코인 이체 (청산 방어, 잔고 리밸런싱) |
출금 권한은 거래소 간 코인 이체에 필요합니다. 선물 포지션의 청산 방어나 현물·선물 거래소 간 코인 잔고 균형 유지를 위해 자동 이체 기능이 사용됩니다.
보안이 걱정된다면, 비트겟의 출금 주소 화이트리스트 기능을 활용하세요. 사전에 등록된 주소로만 출금이 가능하도록 설정하면, API 키가 유출되더라도 등록되지 않은 주소로는 출금할 수 없어 자산을 안전하게 보호할 수 있습니다.
거래 쌍 설정
- 모든 거래 쌍 허용 또는 특정 거래 쌍만 선택할 수 있습니다
- KimpBee는 다양한 코인을 거래하므로 모든 거래 쌍 허용을 권장합니다
IP 주소 제한 (선택)
- 보안을 위해 KimpBee 실행 PC의 IP를 등록할 수 있습니다
- 설정하지 않으면 모든 IP에서 접근 가능합니다
- 고정 IP 환경이라면 IP 제한을 설정하는 것이 안전합니다
API 키 확인 및 저장
- 생성이 완료되면 API Key, Secret Key, 그리고 설정한 Passphrase 3가지를 확인합니다
- Secret Key는 생성 시에만 확인 가능합니다. 반드시 안전한 곳에 저장하세요
- Passphrase도 별도로 기록해두세요
KimpBee에 등록하기
KimpBee API 키 설정
- KimpBee 앱 실행 → 좌측 메뉴에서 "API 키" 선택
- 비트겟 섹션에 다음을 입력합니다:
- API Key: 발급받은 API Key
- Secret Key: 발급받은 Secret Key
- Passphrase: 설정한 Passphrase
- "연결 테스트" 버튼으로 정상 연동을 확인합니다
API 키는 보안을 위해 3개월에 한 번씩 삭제 후 재발급하는 것을 권장합니다. 기존 키를 삭제하고 새 키를 발급받아 KimpBee에 다시 등록하세요.
문제 해결
| 증상 | 해결 방법 | |------|----------| | "인증 실패" 오류 | API Key, Secret Key, Passphrase 3가지 모두 정확한지 확인하세요 | | "권한 부족" 오류 | API 키 권한에서 "읽기"와 "거래"가 활성화되어 있는지 확인하세요 | | "IP 제한" 오류 | IP 제한을 설정했다면 현재 PC의 IP가 등록되어 있는지 확인하세요 | | "선물 거래 불가" 오류 | 비트겟에서 선물 계정이 활성화되어 있는지 확인하세요 (선물 페이지에서 약관 동의 필요) |
업비트와 비트겟 API 키 등록이 모두 완료되면, KimpBee에서 "연결 테스트"를 실행하여 양쪽 거래소 모두 정상 연결되는지 확인하세요. 이제 전략을 설정하고 김프 차익거래를 시작할 준비가 완료되었습니다!