바이낸스 API로 퀀트 트레이딩이나 데이터 분석을 할 때 가장 골치 아픈 문제 중 하나가 빈도 제한입니다. 너무 빠르면 IP가 차단되고, 너무 느리면 전략 실행에 영향을 줍니다.
바이낸스 API의 빈도 제한
바이낸스 가입 후 API Key를 생성하면 다음 빈도 제한을 준수해야 합니다:
REST API 제한
요청 가중치(Request Weight)
바이낸스는 단순히 분당 요청 횟수를 제한하는 것이 아니라 "가중치" 시스템을 사용합니다. 인터페이스마다 다른 가중치를 소모합니다:
- 일반 시세 조회: 가중치 1-5
- 호가창 데이터 조회: 가중치 5-50(요청 깊이에 따라)
- 주문 작업: 가중치 1
- 계정 정보 조회: 가중치 5-10
기본 한도:
- 분당 1200 가중치(IP 기준)
- 10초당 100회 주문(계정 기준)
- 일일 200,000회 주문(계정 기준)
WebSocket 제한
- 단일 연결 최대 200개 데이터 스트림 구독
- IP당 최대 WebSocket 연결 수 제한 있음
- 연결당 초당 최대 5개 메시지
사용량 확인 방법
각 API 응답의 Header에 현재 사용 현황이 반환됩니다:
X-MBX-USED-WEIGHT-1m: 현재 1분간 사용된 가중치X-MBX-ORDER-COUNT-10s: 현재 10초간 주문 횟수X-MBX-ORDER-COUNT-1d: 현재 일일 주문 횟수
이 Header 정보를 읽어 사용량을 모니터링하세요.
한도 초과 시 어떻게 되나요?
HTTP 429
빈도 제한을 초과하면 API가 HTTP 429 오류(Too Many Requests)를 반환합니다:
- 해당 IP 또는 계정이 일시적으로 제한됨
- 쿨다운 시간 후에 복구 가능
- 쿨다운은 보통 몇 초~몇 분
HTTP 418
계속 한도를 초과하면 418 오류를 받을 수 있으며, IP가 더 긴 시간(몇 분~며칠) 차단됩니다.
한도 초과 방지 방법
1. 폴링 대신 WebSocket 사용
실시간 시세 수집에 REST API를 반복 호출하지 말고 WebSocket 데이터 스트림을 사용하세요. WebSocket은 푸시 방식으로 REST API 가중치를 소모하지 않습니다.
2. 요청 병합
여러 거래 쌍 정보가 필요하면 일괄 인터페이스로 한 번에 가져오세요.
3. 데이터 캐싱
실시간성이 필요 없는 데이터(거래 규칙, 코인 정보 등)는 매번 요청하지 말고 로컬에 캐시하고 정기적으로 새로고침하세요.
4. 가중치 사용량 모니터링
코드에서 각 요청의 가중치 소모를 기록하고, 한도에 가까워지면 자동으로 속도를 줄이세요.
5. 합리적인 요청 빈도 조절
딜레이로 요청 빈도를 제어하고, 한꺼번에 모두 보내지 마세요.
계정 등급별 한도 차이
VIP 등급이 높을수록 API 빈도 제한이 넓어집니다:
- 일반 사용자: 표준 한도
- VIP 1-3: 약간 향상
- VIP 4+: 더 높은 가중치 및 주문 한도
- 마켓 메이커 계정: 최고 한도
전략에 더 높은 빈도가 필요하면 VIP 등급 향상을 고려하세요(거래량 증가 또는 BNB 보유).
자주 묻는 질문
Q: 여러 IP로 제한을 우회할 수 있나요? 가중치 제한은 IP 기준과 계정 기준이 있습니다. 여러 IP로 IP 기준 제한은 우회할 수 있지만 계정 기준 주문 제한은 우회할 수 없습니다.
Q: 테스트 환경 한도가 같나요? 테스트넷(testnet)의 한도는 메인넷과 다를 수 있습니다.
Q: 한도가 변경되나요? 네. 바이낸스는 시스템 부하에 따라 한도를 조정할 수 있으며, 공지사항에서 최신 정보를 확인하세요.
앱이 아직 없다면 먼저 바이낸스 앱을 다운로드하세요.
정리
바이낸스 API는 가중치 시스템으로 빈도를 제어하며, 기본 분당 1200 가중치입니다. 초과 시 429 또는 418 오류가 발생합니다. WebSocket 사용, 요청 병합, 데이터 캐싱, 가중치 모니터링 등으로 최적화할 수 있으며, VIP 등급이 높을수록 한도가 더 큽니다.