요청 수 제한

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

기준 일자 : 2020-03-03
업데이트 일자 : 2024-04-01

. 요청 수 제한 기준 변경 건 (계정 단위 측정, 분당 제한 해제)을 반영하였습니다.
. 주문 이외 API의 요청 수 제한 기준을 추가 안내드립니다.
. 계정당 Key 발급 가능개수를 추가 안내 드립니다.

공통사항

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

EXCHANGE API

[주문 요청]

초당 8회
- EXCHANGE API 중 POST v1/orders만 해당

[주문 요청 외 API]

초당 30회
- 트래블룰 검증하기 api의 경우 동일한 입금 건에 대해선 10분당 1회 요청이 가능합니다. 자세한 내용은 관련문서를 참고 부탁드립니다.

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

QUOTATION API

WebSocket 요청 수 제한
1. 헤더에 인증 정보(jwt token)를 담아 WebSocket 연결 요청 시 계정단위로 측정됩니다. (*Public 데이터 수신을 위해서는 별다른 인증이 필요 없으나 Private 데이터 수신을 위해서는 인증 필요)
  - WebSocket 연결: 초당 5회
  - WebSocket 데이터 요청*: 초당 5회, 분당 100회
    *연결이 이루어진 후, 요청하는 내 체결 데이터 (My Trade) 등
2. 인증 정보 없이 WebSocket 연결 요청 시 IP 단위로 측정됩니다.
  - WebSocket 연결: 초당 5회
  - WebSocket 데이터 요청*: 초당 5회, 분당 100회
    *연결이 이루어진 후, 요청하는 특정종목의 현재가/체결/호가 등
REST API 요청 수 제한은 IP 단위로 측정됩니다.

초당 10회 (종목, 캔들, 체결, 티커, 호가별 각각 적용)

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

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

[잔여 요청 수 확인 방법]

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

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

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

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