바이낸스 API 키 생성 방법
API 키란
API(Application Programming Interface) 키는 바이낸스에서 생성한 키 쌍으로, API Key와 Secret Key로 구성됩니다. API 키를 통해 서드파티 애플리케이션이나 직접 작성한 프로그램이 바이낸스 계정에 안전하게 연결하여, 계정 정보 조회, 주문 거래 등의 작업을 바이낸스 웹사이트에 직접 로그인하지 않고도 수행할 수 있습니다.
API 키는 다음과 같은 시나리오에서 널리 사용됩니다:
- 퀀트 거래: 거래 봇을 통해 전략 자동 실행
- 포트폴리오 관리: 서드파티 자산 추적 도구 연결
- 데이터 분석: 시장 데이터 및 거래 내역 조회
- 세금 보고: 암호화폐 세금 계산 도구 연결
API 키 생성 전 조건
API 키를 생성하기 전에 다음을 확인하세요:
- 신원 인증(KYC) 완료
- 2단계 인증(2FA) 활성화
- API의 용도와 필요한 권한 명확히 파악
API 키 생성 단계
바이낸스 APP에서 생성
- 바이낸스 APP 열기
- 좌측 상단 프로필 아이콘 → "보안" 터치
- "API 관리" 옵션 찾기
- "API 생성" 터치
- API 유형 선택:
- 시스템 생성 API 키: 일반적인 키 쌍
- 자체 생성 API 키(Ed25519 또는 RSA): 고급 사용자용
- API의 라벨/이름 입력 (예: "퀀트 거래 Bot")
- 보안 인증 완료 (구글 인증 코드 + 이메일 인증 코드 + SMS 인증 코드)
- 시스템이 API Key와 Secret Key 생성
바이낸스 웹에서 생성
- 바이낸스 공식 웹사이트에 로그인
- 우측 상단 프로필 아이콘 → "API 관리" 클릭
- API 라벨 이름 입력
- "API 생성" 클릭
- 보안 인증 완료
- API Key와 Secret Key 획득
키 저장 (매우 중요)
Secret Key는 한 번만 표시됩니다! 생성 성공 후 반드시 즉시 Secret Key를 안전한 곳에 저장하세요:
- 암호화된 비밀번호 관리자에 저장
- 수기로 백업하여 안전한 장소에 보관
- 코드에 평문으로 저장하지 않기
- 이메일이나 채팅 도구로 전송하지 않기
Secret Key를 분실하면 현재 API를 삭제하고 새로 생성해야 합니다.
API 권한 설정
API 생성 후 사용 요구에 맞게 권한을 설정해야 합니다. 권한 설정은 최소 권한 원칙을 따릅니다 — 실제로 필요한 권한만 활성화하세요.
사용 가능한 권한 설명
| 권한 | 기능 | 리스크 수준 | 권장 |
|---|---|---|---|
| 정보 읽기 | 계정 잔액, 거래 기록 조회 | 낮음 | 필요에 따라 활성화 |
| 현물 거래 | 현물 시장에서 주문 거래 | 중간 | 퀀트 거래에 필요 |
| 선물 거래 | 선물 시장에서 주문 거래 | 높음 | 선물 퀀트에 필요 |
| 출금 | API를 통해 암호화폐 출금 허용 | 극히 높음 | 활성화를 강력히 비추천 |
| 레버리지 거래 | 레버리지 기능 사용 | 높음 | 필요에 따라 활성화 |
권한 설정 권장 사항
조회만 (가장 안전):
- 활성화: 정보 읽기
- 적용 대상: 자산 추적 도구, 세금 보고
거래 용도:
- 활성화: 정보 읽기 + 현물 거래
- 적용 대상: 퀀트 거래 봇
절대 피해야 할 것:
- 리스크를 완전히 이해하고 실제로 필요한 경우가 아니라면 출금 권한을 활성화하지 마세요
- 출금 권한을 활성화하면 API가 유출될 경우 자금이 전송될 수 있음
IP 화이트리스트 설정 (강력 추천)
IP 화이트리스트는 API 보안의 핵심 방어선입니다. 설정 후 지정된 IP 주소의 요청만 수락됩니다.
설정 방법
- API 관리 페이지에서 생성된 API 찾기
- "제한 편집" 클릭
- "신뢰할 수 있는 IP만 접근 허용" 선택
- 서버 또는 컴퓨터의 공인 IP 주소 입력
- 설정 저장
IP 화이트리스트 주의사항
- 가정용 인터넷을 사용하는 경우 IP가 변경될 수 있어 정기적으로 업데이트 필요
- 클라우드 서버(예: AWS, 알리클라우드)에서 거래 봇을 운영하면 서버 IP가 비교적 고정
- 여러 IP 주소 추가 가능
- IP 화이트리스트를 설정하지 않으면 API가 읽기 전용 권한으로 제한될 수 있음
API 키 보안 관리
1. API 키를 유출하지 않기
- GitHub 등 코드 호스팅 플랫폼에 API 키가 포함된 코드를 공개하지 않기
- 환경 변수나 설정 파일로 키를 저장
- 공개 포럼이나 소셜 미디어에서 키를 공유하지 않기
2. 환경 변수 사용
코드에서 API 키를 직접 작성하지 않고, 환경 변수로 참조하세요:
# 좋은 방법
API_KEY = os.environ.get('BINANCE_API_KEY')
# 나쁜 방법
API_KEY = 'your_actual_api_key_here'
3. 정기적으로 키 교체
3-6개월마다 API 키를 교체하는 것을 권장합니다:
- 새로운 API 키 생성
- 이전 키를 사용하는 모든 애플리케이션 업데이트
- 새 키가 정상 작동하는지 확인
- 이전 API 키 삭제
4. API 활동 모니터링
정기적으로 바이낸스 API 관리 페이지에서 확인하세요:
- API 호출 빈도가 정상인지
- 비정상적인 거래 작업이 있는지
- 낯선 IP의 접근이 있는지
5. 거래 제한 설정
API를 거래에 사용하는 경우, 서드파티 도구에서 설정하세요:
- 단건 거래 금액 상한
- 일일 거래 횟수 제한
- 손절 보호
API 키 삭제
더 이상 특정 API 키가 필요하지 않거나, 키가 유출된 것으로 의심되면 즉시 삭제해야 합니다:
- API 관리 페이지 진입
- 삭제할 API 찾기
- "삭제" 클릭
- 보안 인증 완료
- API 즉시 무효화
자주 묻는 질문
Q: API 키에 수량 제한이 있나요? A: 네, 바이낸스는 보통 계정당 최대 30개의 API 키를 생성할 수 있도록 제한합니다. 서로 다른 용도에 대해 다른 API 키를 생성하는 것을 권장합니다.
Q: API 키에 유효 기간이 있나요? A: API 키는 자동 만료 시간이 없으며, 본인이 수동으로 삭제하거나 바이낸스가 보안상 비활성화하지 않는 한 유지됩니다. 하지만 정기적으로 교체하는 것을 권장합니다.
Q: API 거래에 수수료 할인이 있나요? A: API 거래의 수수료는 일반 거래와 동일하며, VIP 등급과 BNB 수수료 공제 사용 여부에 따라 결정됩니다.
Q: Secret Key를 잊어버리면 어떻게 하나요? A: Secret Key는 복구할 수 없습니다. 현재 API를 삭제하고 새로운 API 키를 생성해야 합니다.