AnnouncementsGuidesAPI ReferenceSupportFAQ

요청 수 제한

회원님들께서 Open API 사용 시, 더 정확하게 요청 수 조건을 확인하실 수 있도록 아래와 같이 EXCHANGE API와 QUOTATION API의 요청 수 제한을 안내 드립니다.

기준 일자 : 2020-03-03
업데이트 일자 : 2022-08-17
. 주문 이외 API의 요청 수 제한 기준을 추가 안내드립니다.
. 계정당 Key 발급 가능개수를 추가 안내 드립니다.

공통사항

  • Open API 키 발급 당시 입력한 IP 주소로만 접속해야 Open API 사용이 가능하며, 키당 최대 5개까지 등록할 수 있습니다.
  • Open API 키는 계정당 10개까지 발급이 가능합니다.
  • 한 계정에서 여러 API 키를 사용하시는 경우 각 키마다 독립적으로 요청 횟수가 측정됩니다.
  • Open API를 사용하기 위해선 사용기능 선택과 사용하실 IP 주소를 반드시 입력해야 Open API 키 발급이 가능합니다. 키 발급과 관리는 해당페이지에서 가능합니다. Open API를 통해 키 리스트를 조회하고자 하시는 경우 API 키 리스트 조회 안내 페이지를 참고하시기 바랍니다.

EXCHANGE API

[주문 요청]

  • 초당 8회, 분당 200회

[주문 요청 외 API]

  • 초당 30회, 분당 900회

[Exchange API 추가 안내 사항]
. 본 기준은 개별 Open API Key에 대한 요청 수 제한 기준 입니다.
. 본 기준 내의 요청의 경우에도 하나의 계정으로 여러 개의 Open API Key를 이용하여 요청할 경우, 업비트 전체 서비스의 안정적인 제공을 위하여 요청 수 제한이 발생할 수 있습니다.
. 서비스 및 서버 상황 등에 따라 상기 요청 수가 일시적으로 보장되지 않을 수 있습니다.
. 사용 가능한 잔여 요청 수는 하단의 잔여 요청 수 확인 방법을 참고하시어 확인하실 수 있습니다.
. (업데이트) 주문 요청 API와 주문 요청 외 API 요청 수 제한은 별도로 계산 됩니다.

QUOTATION API

  1. WebSocket 요청 수 제한
  • WebSocket 연결: 초당 5회, 분당 100회
  • WebSocket 요청: 초당 5회, 분당 100회
    *연결이 이루어진 후, 요청하는 특정종목의 현재가/체결/호가 등
  1. REST API 요청 수 제한
  • 초당 10회, 분당 600회 (종목, 캔들, 체결, 티커, 호가별 각각 적용)

[Quotation API 추가 안내 사항]
. Quotation API의 요청 수 제한은 IP 주소를 기준으로 합니다.
. 향후 안정적인 서비스 제공을 위하여 API 요청 수는 추가적인 조정이 이루어질 수 있습니다. 요청 수 조정 필요 시 별도 공지를 통해 안내드리겠습니다.
. 초당 제한 조건과 분당 제한 조건 중 하나의 조건이라도 요청 수를 초과할 경우 요청 수 제한 적용 됩니다.
. 요청 수 제한 조건에 적용되는 시간 조건은 첫 요청 시간을 기준으로하며, 일정 시간 이후 초기화됩니다.(실패한 요청은 요청 횟수에 포함되지 않습니다.)
. 다수의 REST API 요청이 필요하신 경우, 웹소켓을 통한 수신 부탁드립니다.

안정적이고 고도화된 서비스 제공을 위하여 항상 노력하는 업비트 개발자 센터가 되겠습니다.
추후 요청 수 제한 기준의 변경이 있을 경우, 공지를 통하여 안내해 드릴 수 있도록 하겠습니다.

[Exchange API 잔여 요청 수 확인 방법]

업비트 Open API 서비스는 원활한 사용 환경을 위해 초당 / 분당 요청 수를 제한하고 있습니다.
Open API 호출 시 남아있는 요청 수는 Remaining-Req 응답 해더를 통해 확인 가능합니다.

Remaining-Req: group=default; min=1799; sec=29

위와 같은 포멧의 응답 해더를 수신했다면, default 라는 그룹에 대하여 해당 초에 29개의 요청, 남은 1분간 1799개의 요청이 가능하다는 것을 의미합니다.

주문하기 Open API의 경우, 

Remaining-Req: group=order; min=59; sec=4

위와 같은 응답이 올 수 있으며, 이는 order 라는 그룹에 대해 해당 초에 4번, 남은 1분은 59번의 주문 요청이 가능하다는 것을 의미합니다.

🚧

해당 시간 내 초과된 요청에 대해서 429 Too Many Requests 오류가 발생할 수 있습니다. 하지만 별도의 추가적인 페널티는 부과되지 않습니다.

Updated 9 months ago