API 요청 수 제한

서비스 안정성과 공정한 사용을 위해 API 호출 횟수를 제한합니다. 제한을 초과하면 429 Too Many Requests 응답이 반환됩니다.

제한 정책

REST API

구분	제한	단위
초당 요청	10회	API Key 기준
분당 요청	200회 (Weight 합산)	API Key 기준
일일 요청	100,000회	API Key 기준

WebSocket

구분	제한
최대 동시 연결 수	IP당 5개
구독 메시지 전송	연결당 초당 5회
최대 구독 채널 수	연결당 50개

API별 가중치 (Weight)

일부 API는 처리 비용에 따라 가중치가 다릅니다. 1분 동안 Weight 합계가 200을 초과하면 Rate Limit에 도달합니다.

API	Weight
현재가 / 캔들 / 호가 조회	1
계좌 잔고 조회	1
주문 생성 / 취소	1
주문 내역 조회	2

응답 헤더

모든 API 응답에 Rate Limit 관련 헤더가 포함됩니다.

헤더	설명
`X-RateLimit-Limit`	분당 최대 요청 가능 횟수
`X-RateLimit-Remaining`	현재 윈도우에서 남은 요청 횟수
`X-RateLimit-Reset`	제한이 초기화되는 Unix timestamp (초)
`Retry-After`	초과 시 재시도까지 대기 시간 (초)

초과 시 대응

{
  "code": "OA_008",
  "message": "Rate limit exceeded",
  "detail": "API 호출 제한을 초과했습니다. 잠시 후 다시 시도해 주세요.",
  "timestamp": "2026-03-05T14:30:00.000Z"
}

반복 초과 시 보안 조치

1시간 내 Rate Limit 초과가 5회 이상 발생하면 관리자 알림이 전송되며, 지속적 위반 시 Open API 사용이 해지될 수 있습니다.

Python — Rate Limit 대응 코드 예시

권장사항

항목	설명
실시간 시세	REST 폴링 대신 WebSocket 사용
대량 조회	페이징 활용
요청 빈도	초당 제한의 80% 이하로 유지
에러 처리	`Retry-After` 헤더 값 준수
중복 요청	클라이언트 측 캐싱으로 최소화

← 이전: WebSocket 연동

제한 정책#

REST API#

WebSocket#

API별 가중치 (Weight)#

응답 헤더#

초과 시 대응#