API 호출 제한이란 무엇인가요?

최종 업데이트: 2026년 3월 27일

당사의 REST 및 WebSocket API에는 짧은 시간 내에 수행할 수 있는 호출 수에 영향을 미치는 호출 제한이 있습니다. 호출 제한은 공격(예: DDoS 공격)으로부터 API를 보호하고, 주문장 조작(예: 대량 주문을 빠르게 제출하고 취소하는 행위)을 방지하기 위해 고안되었습니다.

Spot API 호출 제한은 사용되는 API 인터페이스(REST 또는 WebSocket) 및 수행되는 호출 유형(시장 데이터, 계정 관리, 주문 제출/취소)에 따라 세 가지 섹션(공개, 비공개, 거래)으로 나뉩니다. 선물(REST) API 호출과 관련된 요청 제한에 대해서는 여기에서 지원 문서를 검토하십시오.

공개 (REST 시장 데이터)

Spot 공개 엔드포인트는 Trades 및 OHLC 호출의 경우 IP 주소 및 통화 쌍별로, 다른 모든 공개 엔드포인트 호출의 경우 IP 주소로만 호출이 제한됩니다.

공개 엔드포인트를 초당 1회(또는 그 이하)의 빈도로 호출하면 호출 제한 내에 유지되지만, 이 빈도를 초과하면 호출이 제한될 수 있습니다. 호출 제한에 도달하면 추가 호출은 몇 초 동안(또는 호출 제한이 활성화된 동안 계속 호출이 이루어지면 더 길게) 제한됩니다.

비공개 (REST 계정 관리)

Spot 비공개 엔드포인트는 API 키별로 호출이 제한되며, 0에서 시작하여 각 호출마다 증가하고 시간이 지남에 따라 감소하는 카운터를 기반으로 합니다. 각 API 키의 카운터는 별개이며, 카운터가 최대값을 초과하면 해당 API 키를 사용하는 후속 호출은 제한됩니다. 호출 제한에 도달하면 추가 호출은 몇 초 동안(또는 호출 제한이 활성화된 동안 계속 호출이 이루어지면 더 길게) 제한됩니다.

API 엔드포인트	카운터 증가 (요청당)
계정 내역 엔드포인트 (Ledgers, TradesHistory, ClosedOrders)	+4
스테이킹 엔드포인트 (Stake, Unstake)	+1
기타 모든 엔드포인트 (Balance, TradeBalance 등)	+1
거래 엔드포인트 (AddOrder, CancelOrder 등)	0 (카운터에 영향 없음) 자세한 내용은 거래 호출 제한을 참조하십시오.

계정 인증 레벨	최대 카운터 값	카운터 감소 (초당)
인증됨	20	-0.5
더 높은 제한으로 인증됨	20	-1

거래 (REST 및 WebSocket 주문 제출/취소)

Spot 거래 엔드포인트(REST AddOrder/CancelOrder 및 WebSocket addOrder/cancelOrder)는 계정 및 통화 쌍별로 호출이 제한되며, 주문이 주문장과 상호 작용하는 방식에 따라 결정됩니다.

간단히 말해(TLDR 버전), 각 계정 및 통화 쌍은 거래 호출 제한에 도달하지 않고 매초 사용할 수 있는 최대 포인트 수를 가집니다. 주문 제출, 실행 및 취소는 이러한 포인트를 사용하며, 시간은 이러한 포인트를 보충합니다. 허용된 것보다 더 많은 포인트(계정 유형에 따라 다름)를 사용하면 후속 호출이 제한됩니다.

거래 호출 제한에 대한 자세한 내용은 트레이더가 거래 전략(주문 체결률, 주문장 내 주문 수명 등)에 따라 제출/실행/취소할 수 있는 정확한 주문 수를 계산할 수 있도록 제공됩니다. 다양한 계정 유형 및 기본 거래 전략에 대한 예시가 편의를 위해 제공되며, 더 복잡한 전략에 대한 호출 제한을 결정하기 위한 호출 제한 계산기도 함께 제공됩니다.

API 호출 제한이란 무엇인가요?

더 많은 도움이 필요하신가요?