Binance API Key 최소 권한과 IP 화이트리스트|퀀트 사용자를 위한 3단 설정

Biabaflow가 실제 퀀트 계정으로 API Key의 최소 권한 설정을 처음부터 끝까지 실측합니다. 읽기/쓰기 권한 분리, IP 화이트리스트, Key 순환 주기, 유출 시 응급 대응까지 퀀트 사용자가 그대로 참고할 수 있는 매뉴얼로 정리했습니다.

게시일 2026-07-11 · 약 8 분 · 보안 설정

결론부터 정리하면, Binance API Key의 기본 권한은 "읽기 + 거래"이며 출금 권한은 기본적으로 비활성화되어 있습니다. 대부분의 퀀트 시나리오에서는 "읽기 + 거래"면 충분하고 출금 권한은 굳이 열 필요가 없습니다. 여기에 IP 화이트리스트를 얹으면 Key가 유출되더라도 자산이 인출되는 사고를 원천적으로 차단할 수 있습니다. 시작 전에 Binance 공식 사이트에서 계정 상태와 로그인 기록을 먼저 확인하고, Binance 공식 앱 다운로드 페이지에서 최신 클라이언트로 접속 환경을 정비해 두세요. 이 세팅은 10분 정도면 끝낼 수 있으며 퀀트 사용자가 반드시 수행해야 하는 기본 과제입니다. Biabaflow 실측 팀이 실제 퀀트 계정으로 전 과정을 재현하여 이 매뉴얼로 정리했습니다.

1. API Key 권한 계층

1.1 세 가지 기본 권한

  • Enable Reading: 읽기 전용. 잔고와 주문 이력 조회 가능.
  • Enable Spot & Margin Trading: 현물 및 마진 거래.
  • Enable Withdrawals: 출금(기본 비활성화).

1.2 부가 권한

  • Enable Futures: 선물 거래.
  • Universal Transfer: 계정 간 이체.
  • Options: 옵션 거래.

1.3 최소 권한 원칙

Q: 왜 최소 권한을 지켜야 하나요?

A: Key가 유출되면 공격자가 수행할 수 있는 조작 범위는 부여된 권한으로만 제한됩니다. 부여하는 권한이 적을수록 유출 시 피해가 작아집니다. 퀀트 목적이라면 주문 실행과 계정 조회만 가능하면 되고, 그 외 권한은 모두 꺼두는 것이 원칙입니다.

2. API Key 생성 전체 흐름

2.1 절차

순서대로 진행합니다.

  1. 웹 www.binance.com/ko로 로그인.
  2. 프로필 아이콘 → API 관리.
  3. Key 이름 입력(예: quant-2026-07).
  4. 이메일 + 2FA 인증.
  5. 시스템이 API Key와 Secret Key를 생성.
  6. Secret Key를 즉시 복사 저장(1회만 표시됨).
  7. 권한과 IP 화이트리스트 설정.

2.2 Secret Key 보관

Secret Key는 생성 시점에 딱 한 번만 노출되며 이후에는 조회할 수 없습니다. 곧바로 비밀번호 관리자 또는 암호화 파일에 옮겨 두세요.

Q: Secret Key를 잊어버렸다면?

A: 복구할 수 없습니다. 기존 Key를 삭제하고 새 Key를 다시 생성하는 것 외에는 방법이 없습니다.

2.3 권한 선택

실제로 필요한 권한만 체크합니다. 시세 모니터링처럼 순수 조회 프로그램은 Reading만 체크하고 나머지는 열지 마세요. 권한을 나중에 다시 조정하려면 이메일과 2FA 인증을 다시 거쳐야 하므로, 처음부터 최소 조합으로 시작하는 편이 관리 부담이 적습니다.

3. IP 화이트리스트

3.1 왜 반드시 켜야 하는가

IP 화이트리스트를 열지 않으면 Key를 확보한 누구든 외부에서 주문을 낼 수 있습니다. 화이트리스트를 켜면 Key가 유출되어도 지정된 IP 이외에서는 호출 자체가 불가능하므로 실질적인 방어선이 됩니다.

3.2 흔한 IP 구성

  • 가정용 회선: 집의 고정 IP 또는 IPv6 프리픽스.
  • VPS 배포: VPS의 고정 IP.
  • 클라우드 함수: 함수 실행 환경 IP 대역.

3.3 다중 IP 화이트리스트

Q: 여러 IP를 등록할 수 있나요?

A: 가능합니다. 쉼표로 구분해서 넣으면 됩니다. 필수 IP만 등록하고 편의성 때문에 넓은 범위를 열어두지는 마세요.

구성 보안 수준 적합한 시나리오
단일 IP 매우 높음 VPS 퀀트
집 + 회사 높음 수동 거래
하나의 /24 대역 중간 클라우드 함수
IP 제한 없음 매우 낮음 권장하지 않음

4. Key 순환 주기

4.1 권장 주기

  • 고빈도 거래 Key: 30~60일 순환.
  • 중저빈도 Key: 90일 순환.
  • 읽기 전용 모니터링 Key: 180일 순환.

4.2 순환 절차

순서대로 진행합니다.

  1. 새 Key 생성.
  2. 퀀트 시스템에 배포.
  3. 새 Key의 정상 동작 검증.
  4. 기존 Key 삭제.
  5. 비밀번호 관리자 항목 갱신.

4.3 응급 삭제

Key 유출이 의심되면 즉시 삭제합니다. 삭제 후 5초 이내에 Key가 무효화되어 공격자가 더 이상 조작할 수 없습니다.

5. Key 유출 시 응급 절차

순서대로 진행합니다.

  1. 웹 로그인 → API 관리.
  2. 유출이 의심되는 Key를 식별.
  3. "Delete" 클릭으로 즉시 삭제.
  4. 최근 24시간의 주문 및 출금 기록 확인.
  5. 이상 주문이 있으면 공식 지원 티켓 신청.
  6. 계정 비밀번호 변경 + 2FA 재설정.
  7. 24시간 뒤 새 Key 생성, 더 엄격한 IP 화이트리스트로 설정.

5.1 유출 경로 조사

Q: GitHub에서 유출된 걸까요?

A: 충분히 가능합니다. GitHub에서의 API Key 유출은 퀀트 사용자에게서 가장 자주 발생하는 사고입니다. git-secrets 또는 pre-commit hook으로 커밋을 차단하는 것이 필수 도구입니다.

5.2 공공 PC에서 Key를 생성하지 말 것

Q: PC방에서 Key를 만들어도 되나요?

A: 안 됩니다. 공용 PC는 키로거와 클립보드 모니터링 위험이 있습니다. 반드시 신뢰할 수 있는 개인 기기에서만 생성하세요.

API 설정을 마친 뒤 계정을 점검하려면 Binance 공식 사이트에서 로그인하여 최근 기기 접속 기록을 확인하고, 모바일 사용자는 Binance 공식 앱 다운로드 페이지에서 최신 클라이언트를 유지하세요. 일상적인 재점검 경로는 App 다운로드 페이지와 공식 진입 특집에서 이어갈 수 있습니다.

5.3 리스크 안내

"API 성능을 최적화해 준다", "주문 대행으로 체결 속도를 높여 준다"고 광고하는 제3자 서비스는 본질적으로 사용자의 API Key를 넘겨받으려는 것입니다. Key를 넘긴 순간 자산 통제권이 상대에게 넘어가므로 Biabaflow는 강력히 권하지 않습니다.

6. 시나리오별 권장 설정

시나리오 권한 IP 화이트리스트
시세 모니터링 읽기 전용 서버 IP
그리드 퀀트 읽기 + 현물 VPS IP
선물 전략 읽기 + 선물 VPS IP
수동 보조 읽기 + 현물 가정 IP
출금 자동화 개방 비권장 엄격하게

7. Biabaflow의 재검증 약속

  • 분기마다 API 권한 흐름을 다시 확인합니다.
  • 독자의 퀀트 사고 사례를 수집해 자주 묻는 문제에 추가합니다.
  • Binance가 새로운 권한 항목을 도입하면 즉시 반영합니다.

8. 자주 묻는 질문

Q: Enable Withdrawals는 언제 필요한가요?

A: 프로그램 방식의 자동 출금이 반드시 필요한 극소수 시나리오에서만 씁니다. 열 경우에는 IP 화이트리스트와 출금 주소 화이트리스트를 반드시 함께 설정해야 하며 둘 중 하나라도 빠지면 안 됩니다.

Q: API Key는 자동으로 만료되나요?

A: 기본값은 90일이며 자동 만료됩니다. 만료 후에는 수동으로 재생성하거나 연장해야 합니다.

Q: Sub-account의 Key가 메인 계정 권한을 공유하나요?

A: 아니요. 서브 계정 Key는 서브 계정 자산에만 유효합니다.

Q: API 호출 빈도에 제한이 있나요?

A: 있습니다. 각 Key는 가중치 제한을 가지며 초과 시 일시적으로 차단됩니다. 공식 API 문서를 참고해 요청 빈도를 적절히 조절하세요.

Q: Biabaflow는 퀀트 템플릿을 오픈소스로 공개하나요?

A: Biabaflow 실측 사이트는 문서 중심 운영이며 실계좌용 퀀트 템플릿은 제공하지 않습니다. 공식 API 문서와 오픈소스 커뮤니티를 참고하세요.

문서 발행일 2026-07-11, 다음 재검증 예정일 2026-10-01. 설정 완료 후에는 Binance 공식 사이트에서 API 관리 페이지의 활성 Key 목록과 최근 요청 이력을 다시 확인하고, Binance 공식 앱 다운로드 페이지에서 최신 클라이언트를 유지해 알림과 2FA 흐름을 안정적으로 받는 것을 마무리 절차로 권장합니다.