바이낸스 API로 퀀트 트레이딩이나 데이터 분석을 할 때, 요청 빈도 제한은 반드시 알아야 할 내용입니다. 제한을 초과하면 IP가 일시적으로 차단되어 정상적인 거래에 지장을 줄 수 있습니다.
아직 바이낸스 계정이 없다면, 바이낸스 가입을 통해 등록하고 API Key를 생성하세요. 모바일에서도 API를 관리할 수 있으며, 바이낸스 앱 다운로드를 권장합니다.
빈도 제한의 기본 규칙
바이낸스 API에는 두 가지 주요 빈도 제한이 있습니다:
요청 가중치 제한: 각 API 엔드포인트마다 다른 가중치 값이 있습니다. 일반 인터페이스 가중치는 1, 복잡한 쿼리는 5 또는 10일 수 있습니다. 1분당 총 가중치가 제한(보통 1200)을 초과할 수 없습니다.
주문 빈도 제한: 초당 및 일일 주문 횟수에 상한이 있습니다. 초당 최대 10건, 일일 최대 20만 건입니다.
엔드포인트와 권한 조합에 따라 제한값이 다를 수 있으니, 구체적인 사항은 공식 API 문서를 참조하세요.
사용량 확인 방법
매 API 요청의 응답 헤더(Response Header)에 현재 가중치 사용 현황이 포함되어 있습니다. 다음 필드를 주시하세요:
X-MBX-USED-WEIGHT-1M: 현재 1분간 사용된 가중치.
X-MBX-ORDER-COUNT-1S: 현재 1초간 주문 횟수.
X-MBX-ORDER-COUNT-1D: 당일 총 주문 횟수.
프로그램에서 이 값들을 모니터링하고, 상한에 가까워지면 자발적으로 속도를 줄이세요.
초과하면 어떻게 되나
요청 가중치 제한을 초과하면 HTTP 429 에러 코드를 받으며, IP가 일시적으로 차단됩니다. 보통 몇 분간 지속됩니다. 차단 기간 동안 모든 요청이 거부됩니다.
심하게 초과하거나 빈번하게 제한을 트리거하면, 차단 시간이 더 길어질 수 있으며, 수 시간 동안 차단될 수도 있습니다.
초과를 피하는 방법
합리적인 요청 빈도 설계: 시세 데이터를 무한 루프로 요청하지 말고, 적절한 간격을 설정하세요.
폴링 대신 WebSocket 사용: 실시간 시세 데이터는 WebSocket 구독을 사용하면 요청 가중치를 소모하지 않습니다.
배치 처리: 일부 작업은 배치 인터페이스를 지원합니다. 예를 들어 배치 주문은 한 번의 요청으로 여러 주문을 제출할 수 있습니다.
데이터 캐싱: 실시간 업데이트가 필요 없는 데이터는 로컬에 캐시하여 중복 요청을 줄이세요.
차단 해제 방법
단기 차단은 자동으로 해제되니 몇 분 기다린 후 다시 시도하면 됩니다. 장기 차단의 경우 바이낸스 API 지원팀에 문의하여 처리할 수 있습니다.
거래에 영향을 주지 않도록, 프로그램에 재시도 로직을 넣어 429 에러 발생 시 일정 시간 대기 후 자동으로 재시도하는 것을 권장합니다.