크라켄 API의 속도 제한은 얼마입니까?

Kraken API는 IP 당 분당 15 개의 공개 요청과 계정 당 분당 20 개의 개인 요청을 시행하며 매분 시작시 요금 제한이 재설정됩니다.

2025/08/12 20:00

크라켄 API 요율 제한 이해

Kraken API는 모든 사용자의 공정한 사용량을 보장하고 시스템 안정성을 유지하기 위해 속도 제한을 구현합니다. 이러한 한도는 실시간 데이터 또는 자동 거래 전략에 의존하는 개발자와 거래자에게 중요합니다. 각 API 엔드 포인트에는 요청 유형 (공개 또는 개인)에 따라 특정 임계 값이 있습니다. 시세 데이터 또는 주문서를 검색하는 것과 같은 공개 엔드 포인트는 개인 엔드 포인트에 비해 엄격한 제한이 적으며, 여기에는 주문 배치 또는 확인 잔고와 같은 계정 별 조치가 포함됩니다.

공개 API 엔드 포인트 의 경우 Kraken은 IP 주소 당 분당 최대 15 개의 요청을 허용합니다. 즉, 응용 프로그램이 60 초 창 내에 15 개 이상의 호출을 보내면 /public/Ticker 또는 /public/Depth 와 같은 엔드 포인트로 15 개 이상의 통화를 보내면 후속 요청은 429 너무 많은 요청 HTTP 상태 코드로 거부됩니다. 이 한도는 네트워크 수준에서 시행되며 인증 상태에 관계없이 적용됩니다.

개인 API 엔드 포인트 제한

/private/AddOrder 또는 /private/Balance 와 같은 개인 엔드 포인트 와 관련하여 속도 제한은 IP 주소가 아닌 사용자 계정에 연결됩니다. Kraken은 인증 된 요청에 대해 분당 20 개의 전화를 허용합니다. 이 엔드 포인트에는 유효한 API 키와 서명이 필요하며 한계를 초과하면 다음 순간 창이 재설정 될 때까지 추가 개인 요청이 일시적으로 차단됩니다.

각 개인 API 호출은 하나의 장치를 소비하며 일부 복잡한 작업은 백엔드 처리로드에 따라 여러 장치를 소비 할 수 있습니다. 예를 들어, 추가 유효성 검사 단계로 인해 마진 순서를 배치하면 두 개의 호출로 계산 될 수 있습니다. 개발자는 응답 헤더, 특히 X-BS-Unit-Current , X-BS-Unit-Limit 및 X-BS-Unit-Reset 필드를 통해 사용량을 모니터링해야하며 현재 소비 및 재설정 타이밍에 대한 실시간 통찰력을 제공합니다.

실제로 요금 제한 관리

타격 속도 제한을 피하기 위해 개발자는 응용 프로그램에서 조절 메커니즘을 구현해야합니다. 효과적인 방법 중 하나는 임계 값에 가까워 질 때 요청 수를 추적하고 실행을 지연시키는 토큰 버킷 알고리즘을 사용하는 것입니다. 예를 들어:

• 공개 API 호출 사이에 최소 4 초의 지연을 사용하여 15 분당 한도를 유지하십시오.
• 개인 통화의 경우 공간은 3 초 이상 요청하여 20 콜 임계 값 내에 남아 있습니다.
• 429 개의 응답을받을 때 지수 백 오프를 구현하고 1 초 일시 정지로 시작하여 각 시도가 실패한 후 지연을 두 배로 늘립니다.

또한 공개 엔드 포인트의 캐싱 응답은 API 호출 수를 크게 줄일 수 있습니다. 예를 들어, 수용 가능한 데이터 신선함을 유지하는 동시에 새로 고침하기 전에 시세 데이터를 30 초 동안 저장하면 중복 요청이 피할 수 있습니다.

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

Kraken에서 API 키를 만들 때 사용자는 권한 및 IP 액세스 제한을 사용자 정의 할 수 있습니다. 속도 제한 사용을 최적화하려면 :

• 시장 데이터 용 및 주문 실행을 위해 다른 서비스에 대한 전용 API 키를 생성하십시오. 이를 통해 사용량을 더 잘 추적하고 격리 할 수 있습니다.
• 무단 사용을 방지하고 일관된 속도 제한 속도를 보장하기 위해 각 키를 특정 IP 주소 로 제한하십시오.
• 쿼리 화이트리스트를 활성화하여 특정 엔드 포인트를 사전 승인하여 처리 속도를 향상시키고 오버 헤드를 줄일 수 있습니다.

키를 생성 한 후에는 생산에 배치하기 전에 저주파 호출을 사용하여 항상 샌드 박스 환경에서 테스트하십시오. API 응답에서 X-RateLimit-* 헤더를 모니터링하여 준수를 확인하십시오. 이 헤더에는 다음이 포함됩니다.

• X-RateLimit-Limit : 분당 총 허용 요청 수.
• X-RateLimit-Remaining : 현재 창에 남겨진 요청 수.
• X-RateLimit-Reset : 카운터가 재설정 시점을 나타내는 UNIX 타임 스탬프.

이 헤더를 구문 분석하면 하드 코딩 지연없이 요청 주파수를 동적으로 조정할 수 있습니다.

처리율 제한 오류는 프로그래밍 방식으로 오류가 발생합니다

요율 제한이 초과되면 크라켄은 오류 코드 EAPI:Rate limit exceeded JSON 응답을 반환합니다. 응용 프로그램은 이것을 우아하게 처리해야합니다. 강력한 오류 처리 루틴에는 다음이 포함됩니다.

• 요금 제한 표시기에 대한 HTTP 상태 코드 및 응답 본문 확인.
• 타임 스탬프와 디버깅을위한 엔드 포인트 세부 사항으로 이벤트를 기록합니다.
• X-BS-Unit-Reset 에 표시되는 재설정 시간이 될 때까지 실행을 일시 중지합니다.
• 냉각 기간 후에 만 요청을 다시 시도합니다.

예를 들어, Python에서는 requests 라이브러리를 사용하여 헤더를 검사하고 지연을 관리 할 수 있습니다.

 import requests
 import time 응답 = requests.get ( 'https://api.kraken.com/0/public/ticker', params = { 'pair': 'xbtusd'})


if response.status_code == 429 :

reset_time = int(response.headers.get('X-BS-Unit-Reset', 0)) sleep_duration = max(reset_time - int(time.time()), 1) time.sleep(sleep_duration)
 이를 통해 응용 프로그램은 요금 제한을 존중하고 반복적 인 실패를 피합니다.
 
고주파 애플리케이션을위한 모범 사례

알고리즘 거래 봇과 같은 빈번한 데이터 업데이트가 필요한 응용 프로그램은 고급 전략을 채택해야합니다.

• 가능한 경우 배치를 요청합니다 . 예를 들어, 개별 요청을하는 대신 한 번의 호출 /public/Ticker 로 여러 자산 쌍을 가져옵니다.
• 실시간 데이터에 WebSocket 피드를 사용하십시오. Kraken의 WebSocket API는 휴식률 제한을 소비하지 않고 주문서 업데이트, 거래 및 티커를 제공합니다.
• 프록시 서버 또는 클라우드 인스턴스를 사용하여 여러 IP 주소 에 부하를 배포합니다.
• 자원 경쟁을 최소화하기 위해 피크 외 시간 동안 집중적 인 운영을 예약하십시오.

WebSocket 연결 자체에는 한계가 있습니다. Kraken은 IP 당 최대 10 개의 동시 연결을 허용합니다. 각 연결은 여러 채널을 구독 할 수 있지만 과도한 메시지 속도는 단절을 유발할 수 있습니다.

자주 묻는 질문

크라켄은 계정 레벨에 따라 API 계층을 구별합니까?

아니요, 크라켄은 계정 확인 수준 또는 거래량에 따라 계층 API 요율 제한을 제공하지 않습니다. 모든 사용자는 동일한 기준 제한을받습니다. IP 당 분당 15 개의 공개 전화 및 계정 당 분당 20 개의 개인 전화가 있습니다 . 할당량이 증가한 프리미엄 API 요금제는 없습니다.

크라켄 지원에 연락하여 요금 제한을 늘릴 수 있습니까?

크라켄은 개별 계정의 요금 제한을 높이는 옵션을 제공하지 않습니다. 한계는 플랫폼 안정성을 유지하기 위해 고정되어 있습니다. 더 높은 처리량이 필요한 사용자는 코드를 최적화하거나 WebSockets를 사용하거나 여러 IP에 요청을 배포하도록 권장됩니다.

실패한 API 요청이 요율 제한에 계산됩니까?

예, 유효하지 않은 매개 변수 또는 인증 오류로 인해 실패한 요청을 포함하여 API에 전송 된 모든 요청은 요율 제한에 포함됩니다. 성공적으로 인증 및 처리 된 요청은 반환 속도 제한 헤더를 요청하지만 결과에 관계없이 카운터가 증가합니다.

롤링 또는 고정 속도 제한 Windows는 어떻게 계산됩니까?

크라켄은 시계 분을 기준으로 고정 시간 창을 사용합니다. 카운터는 1 분의 시작시 재설정 (예 : 00 초). 12:00:55에 15 번의 공개 전화를 걸면 5 초만 통과하더라도 12:01:00까지 기다려야합니다.