2026년 Binance API Key 관리와 해지: 권한 분리, IP 화이트리스트, 긴급 스크립트 총정리
2026년 하반기 Binance API Key를 안전하게 다루는 방법: 읽기/거래/출금 3단계 권한 분리, IP 화이트리스트 바인딩, 키 로테이션 주기, 긴급 원클릭 해지 스크립트까지 바로 적용 가능한 체크리스트와 Postman/Python 예제로 정리했다.
제목부터 답부터 말하자면 읽기 전용, 거래, 출금 세 등급의 권한을 각각 다른 API Key로 분리해서 만들고, 고정 IP 화이트리스트에 바인딩한 뒤 긴급 해지용 스크립트를 미리 준비해 두는 것이 2026년 API Key 운용의 최소 표준이다. API Key는 64자리 랜덤 문자열 한 조각에 불과하지만, 일단 유출되면 공격자는 비밀번호도, 2FA도, 문자 인증번호도 없이 곧바로 계정을 조회하고 주문을 넣고 심지어 출금까지 실행할 수 있다. 로그인 비밀번호에 비해 공격면이 더 은밀하고 노출 경로(GitHub, 로그, 에러 스택, 채팅 기록)도 훨씬 다양한 반면 이차 검증 장치는 거의 없어서, 2026년 가장 심각하게 방치되는 공격면 중 하나로 꼽힌다. 이 글은 "왜 위험한가 → 권한 분리 → IP 화이트리스트 → 네이밍과 로테이션 → 긴급 해지 → 도난 대응" 여섯 단락으로 풀어내고, 마지막에는 Python과 Postman에서 곧바로 돌려볼 수 있는 예제까지 붙였다. Binance 공식 사이트 백오피스와 함께 사용하거나 이동 중이라면 Binance 공식 앱을 함께 켜 두고 따라 하면 무리 없이 적용할 수 있다.
왜 API Key는 2026년에 가장 방치되는 공격면인가
일반 유저가 Binance에 로그인하려면 비밀번호, 2FA, 디바이스 지문 세 관문을 모두 통과해야 하지만, API 요청은 Header 한 줄이면 통과된다. API Key가 공개 저장소에 커밋되거나 트로이 목마에 탈취되는 순간, 공격자는 밀리초 단위로 계정 스캔, 주문, 펌프 앤 덤프까지 끝낼 수 있다.
API Key의 물리적 구성
Binance API Key 한 쌍은 두 부분으로 이루어진다. API Key는 공개 키 성격의 식별자(64자), Secret Key는 비공개 키 성격의 서명 시드(64자)다. 모든 REST 요청은 Secret으로 querystring을 HMAC-SHA256 서명한 뒤 signature 파라미터에 붙여 보내야 한다. Secret Key는 생성 순간에 딱 한 번만 화면에 표시되고, 페이지를 닫는 순간 다시는 조회할 수 없다.
공격자가 자주 뚫는 네 가지 유출 경로
첫째, GitHub 공개 리포지토리다. 2026년 상반기 GitGuardian 보고서에 따르면 전 세계에서 매일 새로 노출되는 암호화폐 API Key가 평균 3200개에 달한다. 둘째, 퀀트 전략 스크린샷이다. 초심자들이 Discord 그룹에 코드를 붙여 도움을 청하다 모자이크를 잊는 경우가 많다. 셋째, Windows/macOS 클립보드 탈취형 악성코드다. 넷째, 백도어가 심어진 서드파티 차트 툴이나 TradingView 리버스 프록시 스크립트 사용이다.
전형적인 API Key 공격 시나리오
키를 손에 넣은 공격자는 먼저 읽기 전용 엔드포인트로 잔고와 과거 주문을 훑어 계정 규모를 가늠한다. 이후 곧바로 출금할 수 있는지 확인하고(Enable Withdrawals가 켜져 있으면 그대로 튄다), 거래 권한만 있으면 호가창에서 멀리 떨어진 고가 매도·저가 매수를 걸어 놓은 뒤 자기 다른 계정으로 체결시켜 자금을 세탁한다. 업계에서는 이를 "Rug via API"라고 부른다.
3단계 권한 분리와 최소 권한 원칙
Binance API 권한은 위에서 아래로 읽기 전용, 현물 & 마진 거래, 출금 세 등급으로 나뉜다. 절대 한 개의 Key에 세 등급을 모두 체크해서는 안 된다. 이는 최소 권한 원칙에 정면으로 위배된다.
각 권한이 할 수 있는 일과 없는 일
| 권한 등급 | 가능한 작업 | 불가능한 작업 | 유출 시 손실 등급 |
|---|---|---|---|
| Enable Reading(읽기 전용) | 잔고, 주문, K라인, 체결 내역 조회 | 주문, 취소, 이체, 출금 | 낮음(개인정보 노출) |
| Enable Spot & Margin Trading(거래) | 읽기 + 주문 + 취소 + 마진 대차 | 타 계정 이체, 출금 | 높음(가격 조작·자금 세탁 가능) |
| Enable Withdrawals(출금) | 거래 + 화이트리스트 주소로 출금 | 화이트리스트 외 주소 출금(활성화 시) | 극심(자산 즉시 제로) |
| Enable Futures(선물) | USD-M/COIN-M 선물 거래 | 출금 | 높음(강제 청산·펌핑 위험) |
| Universal Transfer(만능 이체) | 마스터-서브 계정 간 이체 | 외부 출금 | 중간(자산이 서브로 이동) |
왜 하나의 Key로 세 등급이 아니라 세 개의 Key로 나누는가
퀀트 봇이 24시간 돌아가는 동안 가끔은 Postman으로 수동 조회도 한다고 가정해 보자. 만약 모든 권한이 열린 하나의 Key만 사용한다면, 봇 컨테이너가 침해당하는 순간 공격자가 손에 쥐는 것은 전권이다. 세 개로 쪼개 두면 읽기 전용 Key는 모니터링 대시보드에, 거래 Key는 전략 컨테이너에, 출금 Key는 오프라인 백업용 PC에서 한 번 만들어 두고 평소에는 아예 사용하지 않는다. 이렇게 하면 봇 Key가 유출되어도 최악의 시나리오가 거래 층위의 손실에 그치고, 자산이 통째로 빠져나가는 상황은 원천 차단된다.
권장하는 최소 권한 조합
모니터링 대시보드와 모바일 조회는 Enable Reading 하나만. 퀀트 봇은 Enable Reading + Enable Spot & Margin Trading + Enable Futures, 단 Withdrawals는 절대 금지. 그리드 자금 이동 봇은 별도의 Key에 Universal Transfer만. 2026년 기준으로 출금 스크립트는 아예 만들지 말고 웹 백오피스에 로그인해 수동 출금하는 편이 스크립트보다 압도적으로 안전하다.
IP 화이트리스트 바인딩과 네트워크 계층 강화
IP 화이트리스트는 공짜지만 유저의 90%가 건너뛰는 단계다. 활성화하면 Key가 유출되어도 공격자가 지정된 IP 대역이 아니면 Binance가 즉시 -2015 Invalid API-key, IP, or permissions for action 오류를 돌려준다.
화이트리스트에 몇 개까지, 어떤 포맷으로 넣을 수 있나
Binance API는 Key 하나에 최대 20개의 IP 또는 CIDR 대역을 허용한다. 포맷은 1.2.3.4 단일 IP, 1.2.3.0/24 네트워크, IPv6까지 지원한다. 도메인이나 * 와일드카드는 인식하지 않는다.
가정용 동적 IP 회선을 다루는 세 가지 방법
방안 A: 정적 IP를 가진 VPS를 이용. 월 3달러짜리 해외 VPS를 사서 봇을 그 위에 올리고, 화이트리스트에는 VPS 공인 IP만 등록한다. 가장 단순하고 안정적이다. 방안 B: Cloudflare Tunnel + 고정 Worker IP를 활용하지만 지연이 커서 고빈도 전략에는 부적합. 방안 C: 통신사 고정 IP 서비스를 신청. 한국 통신사도 월 몇만 원 수준의 옵션이 있어 집에서 퀀트를 돌릴 수 있다. 셋 중 A가 가장 무난하고, C는 제도적 절차가 있어 해외 거래소용으로는 부담이 있다.
사내망/오피스 네트워크에 CIDR 대역 넣기
오피스 아웃바운드 IP가 203.0.113.0/24(C 클래스)로 나간다면 CIDR 그대로 등록해 동료들도 같은 읽기 전용 Key를 공유할 수 있다. 다만 사무실 네트워크는 어느 PC 한 대가 감염되기만 해도 요청을 보낼 수 있다는 뜻이므로, 이런 환경의 Key는 반드시 읽기 전용으로만 열어 두는 것이 원칙이다.
네이밍 컨벤션과 키 로테이션 주기
API Key 관리 페이지에는 만든 모든 키가 나열되는데, 열 개쯤 쌓이면 어느 게 지금 쓰는 건지 헷갈리기 시작한다. 규칙적인 네이밍과 정기 로테이션은 운영의 기본기다.
추천하는 네이밍 포맷
용도_권한_생성일 포맷을 권한다. 예:
bot_grid_readonly_20260713bot_futures_trading_20260713monitor_dashboard_readonly_20260713postman_manual_readonly_20260713
생성 당일 날짜를 붙이면 90일이 지나 로테이션 대상이 된 키를 한눈에 골라낼 수 있다.
왜 90일 주기 로테이션인가
정보보안 분야의 경험칙에 따르면 키가 90일을 넘도록 교체되지 않으면 조용히 유출됐을 확률이 눈에 띄게 올라간다(코드베이스 히스토리, 로그 백업, 퇴직자 PC 등이 원인이 될 수 있다). 90일은 PCI-DSS나 SOC2 같은 컴플라이언스 기준이 공통으로 채택하는 키 로테이션 주기이고, Binance API Key도 같은 리듬을 따르는 것이 안전하다.
로테이션의 올바른 순서
로테이션은 "지우고 다시 만들기"가 아니다. 그렇게 하면 봇이 멈춘다. 올바른 순서는 이렇다. 먼저 Binance 백오피스에서 새 날짜를 붙인 신규 Key를 생성 → 봇 설정 파일의 Key를 새 값으로 교체하고 재기동 → 24시간 관찰해 정상 동작 확인 → 백오피스로 돌아가 구 Key를 삭제. 이렇게 하면 다운타임 없이 키 교체를 마무리할 수 있다.
긴급 해지 스크립트와 사고 대응 플레이북
REST API 자체는 자기 자신을 해지하는 기능을 지원하지 않는다(공격자가 유출된 키로 자기를 지워 흔적을 없애는 것을 막기 위한 Binance의 의도적 설계다). 따라서 이른바 "원클릭 해지"는 실제로는 "웹 백오피스에 빠르게 로그인해서 삭제" 과정을 반자동화한 스크립트 + 사람의 확정 절차의 조합이다.
긴급 해지의 세 가지 수단
첫째, 웹 UI에서 수동 삭제. 계정 → API 관리 → 대상 Key 찾기 → Delete 클릭. 둘째, Binance 공식 CLI binance-api-manager(2026년 3월 정식 공개). 이는 API Key가 아니라 계정 로그인 토큰 기반으로 동작해 일괄 삭제가 가능하다. 셋째, 긴급 스크립트로 전 미체결 주문을 취소하고 자산을 서브 계정으로 옮겨 사람이 삭제할 시간을 확보한다.
긴급 취소 + 이체 스크립트(Python 예제)
키가 유출된 정황을 감지하는 즉시, 아직 살아 있는 Key로 자산을 안전한 서브 계정으로 옮긴 뒤 웹 로그인 후 Key를 삭제한다. 예시(합법적 자구 목적에 한정, 실제 키 미포함):
import time, hmac, hashlib, requests
from urllib.parse import urlencode
BASE = "https://api.binance.com"
KEY = "YOUR_API_KEY"
SECRET = b"YOUR_SECRET"
def sign(params):
qs = urlencode(params)
sig = hmac.new(SECRET, qs.encode(), hashlib.sha256).hexdigest()
return qs + "&signature=" + sig
def cancel_all(symbol):
p = {"symbol": symbol, "timestamp": int(time.time()*1000), "recvWindow": 5000}
r = requests.delete(BASE + "/api/v3/openOrders?" + sign(p),
headers={"X-MBX-APIKEY": KEY})
print("cancel", symbol, r.status_code, r.text)
def transfer_to_sub(asset, amount, sub_email):
p = {"fromEmail": "main", "toEmail": sub_email,
"asset": asset, "amount": amount,
"timestamp": int(time.time()*1000), "recvWindow": 5000}
r = requests.post(BASE + "/sapi/v1/sub-account/universalTransfer?" + sign(p),
headers={"X-MBX-APIKEY": KEY})
print("transfer", asset, r.status_code, r.text)
if __name__ == "__main__":
for sym in ["BTCUSDT", "ETHUSDT", "SOLUSDT"]:
cancel_all(sym)
transfer_to_sub("USDT", "1000", "safe-sub@example.com")
스크립트 실행이 끝나자마자 브라우저를 열어 Binance 공식 사이트에 로그인하고, API 관리 페이지로 이동해 모든 Key를 삭제한 뒤 마스터 계정 비밀번호와 2FA까지 다시 세팅한다.
Postman으로 잔고를 조회하는 방법(읽기 전용 예시)
평상시 문제 진단은 Postman으로도 충분하다. Header에 X-MBX-APIKEY: 본인의 Key, Query 파라미터에 timestamp와 signature를 붙여 예컨대 GET /api/v3/account?timestamp=1720800000000&signature=xxx처럼 호출한다. 다만 Postman Team 버전은 Key를 클라우드에 동기화하므로 반드시 개인 로컬 버전에서 관리해야 한다.
키 유출 위험 등급표와 도난 대응 순서
모든 유출이 동일하게 심각한 것은 아니다. 등급이 대응 속도를 결정한다.
키 유출 위험 등급표
| 유출 경로 | 위험 등급 | 권장 대응 시간 | 마스터 비밀번호 변경 필요 여부 |
|---|---|---|---|
| Secret Key 평문을 GitHub Public 저장소에 push | 극심 | 5분 이내 해지 | 필요 |
| Secret Key가 Discord/카카오톡 스크린샷에 노출 | 높음 | 30분 이내 해지 | 권장 |
| 읽기 전용 Key가 개인 블로그 이미지에 노출 | 중간 | 24시간 이내 해지 | 불필요 |
| Secret Key가 퇴직자 PC에 남아 있음 | 높음 | 즉시 해지 | 필요 |
| Key는 로컬에만 있었지만 PC에 트로이 목마 감염 | 극심 | 즉시 해지 + OS 재설치 | 필요 |
| 1Password 같은 비밀번호 관리자에만 저장, 유출 없음 | 낮음 | 90일 정기 로테이션 | 불필요 |
도난 대응 6단계 순서
1단계: 즉시 긴급 스크립트로 모든 미체결 주문을 취소. 2단계: USDT/BTC/ETH를 유출되지 않은 서브 계정으로 이체. 3단계: 웹 백오피스에 로그인해 유출된 한 개만이 아니라 모든 API Key를 삭제. 4단계: 마스터 로그인 비밀번호 변경 + 2FA 재바인딩, 자세한 절차는 Binance 2FA 이관 가이드를 참고. 5단계: 출금 주소 화이트리스트에 악성 주소가 추가되었는지 확인, 출금 주소 화이트리스트 관리 참고. 6단계: 고객센터 티켓을 열어 계정 동결과 유출 타임라인을 요청한다. Telegram의 "고객센터"는 100% 사칭이니 무시하고, Binance 고객센터 진위 판별 문서로 진짜 창구를 확인한다.
읽기 전용 Key 하나를 만드는 6단계 표준 작업
- Binance 공식 사이트에 로그인 → 우측 상단 프로필 → API 관리
- "API 생성" 클릭 → "시스템 생성" 선택(자체 호스팅 아님) → 이름을
monitor_dashboard_readonly_20260713으로 지정 - 2FA 인증을 마치면 화면에 API Key와 Secret Key가 표시된다. Secret은 이 한 번만 노출되므로 즉시 비밀번호 관리자에 복사한다
- 권한 체크박스에서 Enable Reading만 체크하고 나머지 세 항목은 반드시 해제
- IP 화이트리스트 칸에 VPS/서버의 공인 IP를 입력한다(
curl ifconfig.me로 확인 가능) - 저장 후 목록 페이지에서 새 Key의 권한 배지가 "Read Only"로 표시되는지 확인하고,
/api/v3/account요청이 200으로 돌아오면 완료
자주 묻는 질문
API Key가 API를 통해 스스로를 삭제할 수 있나요
A: 불가능하다. Binance REST API는 설계상 API Key로 자기 자신이나 다른 Key를 삭제할 수 없게 되어 있다. 유일한 경로는 웹 백오피스 또는 공식 CLI(계정 로그인 토큰 필요)뿐이다. 공격자가 키를 손에 넣자마자 자신을 지워 흔적을 감추는 것을 막기 위한 조치다. 따라서 "긴급 해지 스크립트"의 본질은 "긴급 취소 + 이체 + 사람이 백오피스에서 삭제"의 조합이다.
Secret Key를 잃어버리면 어떻게 하나요
A: 복구는 불가능하며 삭제 후 재생성만 가능하다. Secret은 생성 순간에만 노출되고 Binance 데이터베이스에는 평문이 아닌 해시만 저장된다. Secret이 사라졌지만 전략을 중단하고 싶지 않다면 새 Key를 만들어 매끄럽게 전환한 뒤, Secret을 잃어버린 구 Key를 삭제하는 방법을 쓴다.
IP 화이트리스트를 잘못 넣었으면 어떻게 고치나요
A: 언제든지 Binance 백오피스에서 IP 화이트리스트를 편집할 수 있으며, Key를 삭제하고 재생성할 필요는 없다. 편집은 30초 이내에 반영된다. 다만 "화이트리스트 없음"에서 "화이트리스트 있음"으로 바꿀 때는 이메일 인증코드가 강제되고, 반대로 "있음"에서 "없음"(임의 IP 허용)으로 되돌리면 24시간 쿨다운이 걸려 그동안 출금 기능이 잠긴다. Binance의 안전 장치다.
서브 계정에 별도의 API Key를 발급할 수 있나요
프로 트레이더나 팀 운영에서 흔한 패턴이다. 서브 계정마다 개별 API Key 세트를 발급하고, 마스터 계정 Key는 Universal Transfer 용도로만 남겨 둔다. 서브 계정 Key가 유출되어도 해당 서브 계정의 자산만 영향을 받고 마스터나 다른 서브는 무사하다. 그 자체가 천연 격리막이다.
API Key가 오랫동안 미사용이면 자동 해지되나요
아니다. Binance API Key는 한번 생성되면 사용자가 직접 삭제하거나 계정이 동결되기 전까지 영구 유효하다. 시스템이 대신 정리해 주지 않기 때문에, 90일 주기 로테이션이 그렇게 중요한 것이다.
하나의 IP에서 몇 개의 API Key를 만들 수 있나요
계정당 활성 API Key 상한은 30개다. 삭제된 Key는 슬롯을 반환한다. 팀 협업으로 상한에 도달했다면 만료된/이름 없는 Key를 정리하면 된다.
현물 Key로 선물을 거래할 수 있나요
불가능하다. 현물과 선물은 독립된 권한이다. 봇이 현물과 선물을 동시에 하려면 생성 시 Enable Spot & Margin Trading과 Enable Futures를 함께 체크해야 한다. 더 안전한 방법은 두 개의 Key로 분리해 현물 Key는 현물 전략에만, 선물 Key는 선물 전략에만 사용하는 것이다.
모바일에서 API Key를 만들 수 있나요
가능하다. Binance 앱도 API Key 생성을 지원하며, UI는 "계정" → "보안" → "API 관리" 안에 숨어 있다. 다만 모바일에서는 읽기 전용 Key만 만드는 것이 원칙이고, 거래/출금 Key는 반드시 PC에서 생성해야 한다. 모바일 클립보드 유출 위험을 피하기 위함이다. 스마트폰에서 시세 모니터링을 하고 싶다면 반드시 Binance 공식 앱을 다운로드해서 사용하고, 서드파티 fork는 사용하지 말자.
리스크 고지와 총정리
리스크 고지: 본문의 모든 코드 예제는 합법적인 자기 방어와 개인 연구 목적으로만 사용해야 하며, 타인의 계정에 대한 무단 접근에는 절대 사용해서는 안 된다. 암호화폐 투자 자체가 극심한 변동성을 지니고, 퀀트 전략의 과거 백테스트 수익률이 미래 성과를 보장하지 않는다. API 트레이딩은 네트워크 단절, 급격한 시세 변동, 거래소 점검 등으로 예기치 못한 손실을 낳을 수 있다. 본문의 시점 및 데이터는 2026년 7월 공개 정보를 기준으로 하며, Binance는 언제든지 권한 항목, 화이트리스트 상한, API 엔드포인트를 조정할 수 있으므로 반드시 Binance 공식 사이트의 최신 공지를 우선으로 확인하고, 거래 전에 레버리지와 강제 청산 메커니즘을 충분히 이해해야 한다.
API Key 관리의 핵심은 한 문장으로 압축된다. 세 개의 Key, 한 개의 화이트리스트, 90일 로테이션, 한 벌의 취소 스크립트. 이 네 가지만 지키면 Key가 우연히 유출되더라도 손실은 통제 가능한 범위에 머문다. 계정 보안 전반의 그림을 함께 잡고 싶다면 Binance 2FA 이관 가이드, 출금 주소 화이트리스트 관리, Binance 고객센터 진위 판별 세 편을 이어서 읽으면 "로그인 → API → 출금 → 고객센터"로 이어지는 완결형 보안 체인이 완성된다. 일상 조회는 Binance 공식 사이트에 직접 로그인하고, 이동 중 시세 확인은 Binance 공식 앱 공식 버전을 사용하자. 두 진입점 모두 검색엔진을 거치지 말고 주소를 직접 입력하거나 북마크로 접근한다. 지금 바로 등록하고 10분만 투자해 권한 분리와 화이트리스트를 세팅해 두는 편이, 사고 후 수습에 드는 노력의 100분의 1로 끝난다.
문서 발행일 2026-07-13, 다음 재검토 예정일 2026-10-13