Bybit Contracts의 자동 거래에 대한 API 요율 제한은 얼마입니까?

Bybit은 API 요율 제한 (공개 엔드 포인트의 경우 IP 당 120 개의 요청/5 초, 개인의 경우 API 키 당 60/5 초)을 시행합니다.

2025/08/08 06:08

BYBIT의 API 속도 제한 이해

BYBIT 계약에 대한 자동 거래 에 참여할 때 전략 실행의 중단을 방지하려면 API 요율 제한을 이해하는 것이 필수적입니다. Bybit은 플랫폼 안정성을 유지하고 모든 사용자의 공정한 사용을 보장하기 위해 요금 제한을 시행합니다. 이 제한은 초당 요청 (RPS)에서 측정되며 액세스중인 엔드 포인트 유형 (공개 또는 개인)과 요청의 인증 상태에 따라 달라집니다. 이러한 임계 값을 초과하면 HTTP 429 (너무 많은 요청) 응답이 발생하여 봇 운영을 방해 할 수 있습니다.

시장 데이터 검색, 주문서 스냅 샷 또는 시세 정보와 같은 공개 엔드 포인트의 경우 속도 제한이 일반적으로 더 관대합니다. Bybit은 일반적으로 공개 데이터의 IP 주소 당 5 초당 최대 120 개의 요청을 허용합니다. 이는 실시간 가격 사료를 가져 오거나 시장 깊이를 모니터링하는 자동화 시스템이 통화를 적절하게 공개해야 함을 의미합니다. 그렇게하지 않으면 특히 동일한 네트워크에서 여러 봇이 작동 할 때 스로 틀링을 유발할 수 있습니다.

공공 및 개인 종점 한계의 차이

API 키 인증이 필요한 개인 엔드 포인트는 민감도로 인해 엄격한 제어를받습니다. 여기에는 주문 배치, 거래 취소, 위치 정보 검색 및 지갑 잔액 확인이 포함됩니다. 개인 엔드 포인트의 경우 Bybit은 일반적으로 API 키 당 5 초당 60 개의 요청 제한을 시행합니다. 이는 각 개별 API 키가 초당 평균 12 개의 요청으로 제한되어 있음을 의미합니다.

계정 당 API 키 당 요금 제한이 적용된다는 점에 유의해야합니다. 고주파 전략을 실행하는 거래자는 여러 API 키를 사용하여 부하를 배포하는 것을 고려할 수 있습니다. 그러나 우발적 인 남용을 피하기 위해 각 키는 올바르게 인증되고 모니터링되어야합니다. 또한 주문 배치 또는 취소와 같은 특정 고 충격적인 조치는 페치 위치와 같은 읽기 전용 동작보다 더 많은 요율 제한 "무게"를 소비합니다.

요율 제한 헤더 및 모니터링 사용

Bybit은 개발자가 현재 사용량을 모니터링 할 수있는 모든 API 응답으로 특정 HTTP 헤더를 반환합니다. 가장 중요한 헤더는 다음과 같습니다.

• XATELIMIT-LIMIT : 현재 시간 창에서 허용되는 총 요청 수입니다.
• X-atelimit-remaining : 한도에 도달하기 전에 남은 요청 수입니다.
• XATELIMIT-RESET : 현재 창이 재설정되는시기를 나타내는 UTC 타임 스탬프.

이러한 헤더를 프로그래밍 방식으로 검사함으로써 자동 거래 시스템은 요청 빈도를 동적으로 조정할 수 있습니다. 예를 들어, XATELIMIT-REMAINING이 임계 값 아래로 떨어지면 봇은 추가 요청을 보내기 전에 짧은 지연을 구현할 수 있습니다. 이 사전 예방 접근 방식은 서비스 중단을 방지하고 휘발성 시장 조건에서 더 부드러운 운영을 보장합니다.

일부 거래 프레임 워크는 이러한 헤더를 자동으로 구문 분석하고 배압을 시행하는 미들웨어를 통합합니다. 이것은 여러 동시 전략을 관리하거나 여러 종말점을 동시에 폴링 할 때 특히 유용합니다.

타격 요금 제한을 피하기위한 전략

중단되지 않은 자동 거래를 유지하기 위해 거래자는 불필요한 API 통화를 최소화하는 기술을 채택해야합니다.

• 가능한 경우 배치를 요청합니다 . 주문 상태를 가져 오기 위해 여러 개인 호출을하는 대신 가능한 경우 대량 엔드 포인트를 사용하십시오.
• 재 시도 논리에서 지수 백 오프를 구현하십시오 . 429 오류가 접수되면 다시 시도하기 전에 간격이 증가 할 때까지 기다리십시오.
• 캐시는 기호 정보 또는 최근 거래와 같은 데이터에 자주 액세스하여 API에서 다시 가져와야 할 필요성을 줄입니다.
• 실시간 업데이트에 WebSocket 피드를 사용하십시오 . Bybit은 주문서, 거래 및 계정 업데이트에 대한 WebSocket 엔드 포인트를 제공하며, 이는 반복적 인 휴식 투표보다 훨씬 효율적입니다.

예를 들어, 주문서 변경을 위해 100ms마다 REST API를 폴링하는 대신 WebSocket을 통해 공개 채널 orderbook 를 구독하십시오. 이는 거의 불완전한 업데이트를 제공하면서 요청 수를 크게 줄입니다.

최적의 성능을위한 API 키 구성

자동 거래를위한 API 키를 설정할 때 적절한 구성이 중요합니다. 창조 중에 다음을 확인하십시오.

• 필요한 권한 만 활성화하십시오. 절대적으로 요구되지 않는 한 '양도'또는 '철회'액세스를 부여하지 마십시오 .
• IP 화이트리스트를 봇을 실행하는 서버로 제한하십시오. 이는 보안을 향상시키고 무단 사용을 방지합니다.
• 다양한 전략이나 환경에 별도의 API 키를 사용하십시오 (예 : 테스트 대 라이브).

각 API 키는 동일한 요율 제한 규칙에 따라 작동합니다. 여러 키에 걸쳐 고주파 작업을 배포하면 한도 내에서 유지하는 데 도움이 될 수 있습니다. 그러나 하나의 키가 시스템을 압도하는 것을 방지하기 위해 조정이 필요합니다. 예를 들어:

• 시장 데이터 검색에 대한 하나의 키를 할당하십시오.
• 주문 실행을위한 또 다른 키를 전용하십시오.
• 위치 및 균형 모니터링에는 세 번째 키를 사용하십시오.

이 세분화는 요금 제한을 관리하는 데 도움이 될뿐만 아니라 디버깅 및 모니터링을 향상시킵니다.

자주 묻는 질문

Bybit의 API 요율 제한을 초과하면 어떻게됩니까?

한계를 초과하면 Bybit은 HTTP 429 상태 코드를 반환합니다. API는 창이 재설정 될 때까지 해당 키 또는 IP의 추가 요청을 일시적으로 차단합니다. 영구적 인 처벌은 적용되지 않지만 봇은 블록 중에 중요한 시장 이벤트를 놓칠 수 있습니다.

Bybit의 API 요율 제한을 늘릴 수 있습니까?

아니요, Bybit은 사용자가 기본 속도 제한을 늘릴 수 없습니다. 엔터프라이즈 수준의 고객 또는 기관 거래자는 특별 계약에 대한 지원에 연락 할 수 있지만 표준 사용자는 게시 된 임계 값 내에서 작업해야합니다.

WebSocket 연결은 REST API 요율 제한에 포함됩니까?

아니요, WebSocket 연결은 휴식률 제한과 독립적으로 작동합니다. WebSocket을 통해 데이터 스트림을 구독해도 REST 요청 할당량을 소비하지 않으므로 실시간 데이터에 선호되는 방법이됩니다.

현재 API 사용량을 실시간으로 확인하려면 어떻게해야합니까?

API 응답에서 XATELIMIT-REMAINING 및 XATELIMIT-RESET 헤더를 모니터링하십시오. 거래 봇에 로깅을 구현하여 이러한 값을 추적하고 사용법이 임계 값에 접근 할 때 경고를하십시오.