빗썸 API 키 발급 가이드

• 빗썸 고객센터 — API Key 발급
• 빗썸 Developer Docs — 빠른 시작
• 빗썸 API 문서 홈

[중요] 빗썸 API 관리에서 「자산조회」「주문조회」만 체크한 상태로 API Key를 생성하세요. 주문하기·출금하기 등 실행 권한은 절대 활성화하지 마세요.

[주의] 키를 만든 뒤 「활성화」를 누르지 않으면 연동이 실패합니다. 활성화 전에 Secret을 반드시 복사하세요.

• 자산조회·주문조회만 체크해 활성화한 뒤 API Key 생성
• 주문하기·출금하기는 비활성
• 접근 허용 IP 등록(최대 5개)
• 생성 후 활성화·이메일(또는 SMS) 인증까지 마쳐야 사용 가능
• Secret Key는 발급 직후 한 번만 표시

1. 1. 빗썸 로그인 및 본인인증 확인

   API 발급 전 계정 본인인증이 완료되어 있어야 합니다.

2. 2. API 관리 메뉴 열기

   PC 웹에서 「메뉴 > 계정관리 > API 관리」(또는 마이페이지 > API 관리)로 이동합니다.

3. 3. API 활성 항목 선택

   비트택스용으로는 「자산조회」「주문조회」만 켭니다. 주문하기·출금하기 등 실행 권한은 모두 끈 뒤 API Key를 생성하세요.

4. 4. IP·출금주소 제한 설정

   접근 가능 IP를 등록합니다. 출금 권한이 없다면 출금 주소 제한은 해당 없을 수 있습니다. 비트택스 동기화용 서버 IP가 안내되면 그 값을 넣으세요.

5. 5. API KEY 생성 → Secret 보관 → 활성화

   비밀번호·추가 인증 후 키를 생성하고 Secret Key를 복사합니다. 이어서 활성화 버튼을 누르고 이메일/문자 인증을 완료합니다. 세부 문구는 빗썸 고객센터 FAQ와 동일합니다.

6. 6. 비트택스에 연결

   대시보드 → 거래소 연동 → 빗썸에 API Key / Secret Key를 입력하고 연결 검증 후 동기화합니다.

• NotAllowIP — 등록 IP와 실제 호출 IP 불일치
• out_of_scope — 조회 권한 부족 또는 과도한 권한
• 미활성화 키 — 생성만 하고 활성화를 안 한 경우
• 키 유효기간(발급일로부터 약 1년) 만료 → 재발급