Coinbase Futures 시장의 API 요율 제한은 얼마입니까?

Coinbase Futures API는 속도 제한을 시행합니다. 공개 엔드 포인트의 경우 IP 당 3 REQ/SEC, 개인의 경우 API 키당 10 개의 RQ/SEC; WebSockets 및 Caching을 사용하여 최적화하십시오.

2025/08/11 20:29

코인베이스 선물의 API 요율 제한 이해

API를 통해 코인베이스 선물 시장 과 상호 작용할 때 개발자는 시스템 안정성과 공정한 사용을 유지하도록 설계된 특정 요율 제한을 준수해야합니다. 이 제한은 주어진 시간 내에 사용자가 얼마나 많은 요청을 할 수 있는지 제어합니다. 이러한 임계 값을 초과하면 임시 HTTP 429 너무 많은 요청 응답이 발생하여 속도 제한 창이 재설정 될 때까지 추가 액세스가 중단 될 수 있습니다. 정확한 한계는 종말점 유형, 인증 방법 및 요청이 공개인지 개인인지 여부에 따라 다릅니다.

선물 거래를 지원하는 Coinbase Advanced Trade API 의 경우, 요금 제한은 엔드 당 기준으로 적용됩니다. 주문서 또는 시세 가격과 같은 시장 데이터를 가져 오는 것과 같은 공개 엔드 포인트는 일반적으로 주문 배치 또는 균형 점검과 같은 계정 조치와 관련된 개인 엔드 포인트에 비해 더 높은 요청량을 허용합니다. 이러한 공개 엔드 포인트는 일반적으로 승인되지 않은 경우 IP 주소 당 초당 3 개의 요청 으로 제한됩니다. 이는 API 키가 없으면 액세스가 모든 공공 선물 데이터 엔드 포인트 에서이 임계 값으로 제한되어 있음을 의미합니다.

인증 된 종말점 속도 제한

API 키와 비밀을 사용하여 요청을 인증 할 때는 요금 제한이 IP 주소가 아닌 사용자 계정에 연결됩니다. 이를 통해 특히 자동화 시스템에 의존하는 거래자에게보다 일관되고 더 높은 처리량이 가능합니다. 선물 주문 제출 , 주문 취소 또는 직위 정보 검색과 같은 개인 종점에 대한 인증 된 요청의 경우, 요율 제한은 API 키 당 초당 약 10 개의 요청 입니다. 이 한도는 조절을 피하기 위해 요청 빈도를 신중하게 관리 해야하는 알고리즘 거래자에게 중요합니다.

비율 제한을 초과하면 임시 블록에서 일반적으로 몇 분 동안 지속됩니다. 이를 방지하기 위해 개발자는 지수 백 오프 전략을 구현하고 API가 반환 한 HTTP 응답 헤더를 모니터링해야합니다. 주요 헤더에는 다음이 포함됩니다.

• cb-after-rate-limit-reset : 속도 제한이 재설정 될 때까지 초의 수를 나타냅니다.
• cb-after-rate-limit-remaining : 현재 창에 얼마나 많은 요청이 남아 있는지 보여줍니다.
• cb-after-rate-limit-cap : 창 당 허용되는 총 요청 수를 지정합니다.

이러한 헤더를 모니터링하면 요청 간격을 실시간으로 조정하여 Coinbase의 요금 제어 정책을 준수 할 수 있습니다.

공공 및 개인 엔드 포인트를 차별화합니다

Coinbase Futures API는 각각 별도의 속도 제한을 가진 공공 및 개인 데이터 액세스를 구별합니다. 공개 엔드 포인트에는 다음이 포함됩니다.

• GET/API/V3/중개/시장/제품 - 가용 선물 계약을 검색합니다.
• GET/API/V3/Brokerage/Market/Product_book - 주문서 데이터를 가져옵니다.
• GET/API/V3/중개/시장/양초 - 역사적 가격 촛불을 반환합니다.

이 엔드 포인트는 승인되지 않은 경우 IP 당 3 초당 3 번의 요청 으로 속도 제한됩니다. 인증되면 약간의 관대 한 처리로 이익을 얻을 수 있지만 인증의 주요 장점은 개인 엔드 포인트에 대한 액세스에 있습니다.

유효한 API 자격 증명이 필요한 개인 엔드 포인트에는 다음이 포함됩니다.

• Post/API/V3/중개/주문 - 새로운 선물 주문을합니다.
• 삭제/API/V3/Brokerage/Orders/{order_id} - 기존 주문을 취소합니다.
• GET/API/V3/중개/위치 - 현재 열린 위치를 검색합니다.
• GET/API/V3/중개/계정 - 거래 계정을 나열합니다.

이들은 API 키 당 초당 10 개의 요청 으로 제한되며 지속적인 버스트는 임시 서스펜션을 유발할 수 있습니다. 개발자는 응용 프로그램을 대기열 및 스로틀 요청 으로 설계해야합니다.

실제로 요금 제한 관리

Coinbase의 요율 제한 프레임 워크 내에서 효과적으로 운영하려면 개발자는 강력한 요청 관리를 구현해야합니다. 한 가지 효과적인 방법 중 하나는 토큰 버킷 알고리즘을 사용하는 것입니다. 여기서 각 API 요청은 토큰을 소비하고 토큰을 고정 속도로 보충합니다. 이를 통해 요청이 적절하게 간격을 두도록합니다.

또 다른 실질적인 단계는 가능한 경우 공개 데이터를 로컬로 캐시하는 것 입니다. 예를 들어, 제품 목록 엔드 포인트를 반복적으로 호출하는 대신 계약 사양을 저장하고 몇 분마다 새로 고치십시오. 이는 불필요한 API 호출을 줄이고 주문 실행과 같은 중요한 운영의 요금 제한 예산을 보존하는 데 도움이됩니다.

자동 거래 시스템을 구축 할 때 다음을 고려하십시오.

• 관련 쿼리는 지원되는 단일 요청으로 쿼리를합니다 .
• REST 엔드 포인트를 폴링하는 대신 실시간 시장 데이터에 WebSocket 피드를 사용합니다 .
• cb-after-rate-limit-reset 헤더를 기반으로 지연으로 재시 도로 로직 구현 .

Coinbase Advanced Trade WebSocket 피드 와 같은 WebSocket 연결은 REST API 요율 제한을 소비하지 않고 주문서, 거래 및 계정 변경에 대한 라이브 업데이트를 수신하는보다 효율적인 방법을 제공합니다. level2 , matches 또는 user 와 같은 채널에 가입하면 최소한의 오버 헤드로 연속 데이터 흐름이 가능합니다.

API 키 구성을위한 모범 사례

안정성 및 보안을 최대화하려면 최소한의 필요한 권한으로 API 키를 구성하십시오. 선물 거래의 경우, 무역 및 보도 의 열쇠를 제한하고, 즉 철수 또는 양도 권한을 부여하는 범위 만 보이십시오. 이것은 타협의 경우 위험을 줄입니다.

환경 변수 또는 비밀 관리자를 사용하여 API 비밀 및 암호를 안전하게 저장하십시오. 소스 파일의 하드 코드 자격 증명은 없습니다. 요청을 할 때 모든 헤더가 올바르게 형식화되어 있는지 확인합니다.

• CB-ACCESS-KEY : API 키.
• CB-ACCESS-SIGN : HMAC-SHA256 메시지의 서명.
• CB-ACCESS-TIMESTAMP : 요청의 Unix 타임 스탬프.
• CB-ACCESS-PASSPHRASE : 키를 만들 때 사용되는 암호.

각 요청 본문은 직렬화되고 제대로 서명되어야합니다. 예를 들어, 선물 순서를 작성할 때 메시지 문자열에는 타임 스탬프, HTTP 방법, 요청 경로 및 신체 (현재)가 포함되어 있어야합니다.

자주 묻는 질문

코인베이스 선물에 대한 API 요율 제한을 늘릴 수 있습니까?

아니요, 요금 제한은 API 키 당 고정되어 있으며 계정 업그레이드 또는 지원 요청을 통해 증가 할 수 없습니다. 대량 거래자는 더 높은 한도를 찾는 대신 요청 패턴을 최적화 할 것으로 예상됩니다.

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

아니요, WebSocket 구독은 휴식률 제한을 소비하지 않습니다 . 그들은 별도의 채널에서 작동하며 요청 할당량에 영향을 미치지 않고 실시간 시장 데이터를 수신하는 데 선호되는 방법입니다.

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

HTTP 429 응답을 받게되며, 특히 60 초 미만으로 짧은 기간 동안 추가 요청이 차단됩니다. 지수 백 오프로 재시 도로를 구현하여 이것을 우아하게 처리하십시오.

동일한 계정에서 여러 API 키에 걸쳐 속도 제한이 공유됩니까?

아니요, 각 API 키에는 자체 독립 요율 제한이 있습니다 . 여러 키를 생성하면 병렬화 된 액세스가 가능하지만 개인 엔드 포인트에 대한 각각은 여전히 초당 10 개의 요청으로 제한됩니다.