이용 안내

API 요청건수 제한 안내

원활한 거래환경을 위해 아래와 같이 API의 요청건수를 제한합니다.

API 요청건수 제한

Public API

버전최대 요청건수기준
V21200/분요청 IP 기준
V1600/분요청 IP 기준

Private API

버전 최대 요청건수 기준
V2.1 주문관련 API - 40/초
기타 API - 80/초
포트폴리오 기준
V2주문관련 API - 40/초
기타 API - 40/초
포트폴리오 기준

Private API는 포트폴리오를 기준으로 API 요청건수를 제한합니다.

코인원 홈페이지 > 자산 > 포트폴리오 페이지에서 포트폴리오 관리가 가능합니다.
포트폴리오에 대한 자세한 내용은 이용 가이드를 확인해주세요.


주문 관련 API

PRIVATE API V2.1 > 주문 권한

PRIVATE API > 주문 권한


API 요청 건 수 초과 시 에러 코드

상기 요청건수를 초과하는 경우 아래와 같은 메세지가 수신됩니다.

요청 제한 에러 메세지

{
  "result": "error",
  "error_code": "4",
  "error_msg": "Blocked user access"
}
{
  "result": "error",
  "errorCode": "4",
  "errorMsg": "Blocked user access"
}

API 잔여 요청건수 확인

Open API의 잔여 요청건수는 요청 응답의 아래 Header값을 통해 확인이 가능합니다.
잔여 요청이 가능할 경우에만 해당 Header값이 포함됩니다.

Public API (1분 기준)

구분Header비고
전체 APIPublic-Ratelimit-Remaining(V1 API 의 경우 요청건당 2가 감소합니다)

Private API (1초 기준)

구분Header비고
주문관련 APIPrivate-Order-Ratelimit-Remaining
기타 APIPrivate-Ratelimit-Remaining(V2 API 의 경우 요청건당 2가 감소합니다)