---
updatedAt: 2026-10-27T11:20:21.000Z
agentTools:
  projectIndex: https://apidocs.bithumb.com/llms.txt
---

# API 요청 수 제한 안내

안정적인 서비스 제공을 위해 API 유형별로 초당 요청 수를 제한합니다.

## 요청 제한 기준

API 요청 수는 **IP 주소 및 API 분류 항목별**로 제한됩니다. 개별 엔드포인트별 제한이 아니므로, 같은 분류 항목에 속한 요청 수는 합산됩니다.

<table>
  <thead>
    <tr>
      <th>구분</th>
      <th>분류 항목</th>
      <th>초당 최대 요청 수<br />(IP 기준)</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td rowSpan={5}>Public API</td>
      <td>캔들</td>
      <td rowSpan={5}>분류 항목별 150회</td>
    </tr>
    <tr>
      <td>호가</td>
    </tr>
    <tr>
      <td>현재가</td>
    </tr>
    <tr>
      <td>체결</td>
    </tr>
    <tr>
      <td>기타(마켓 정보, 경보제 조회 등)</td>
    </tr>

    <tr>
      <td rowSpan={3}>Private API</td>
      <td>주문 요청</td>
      <td rowSpan={3}>분류 항목별 140회</td>
    </tr>
    <tr>
      <td>주문 취소 접수</td>
    </tr>
    <tr>
      <td>기타(자산 조회, 입금, 출금, 거래내역 조회, API Key 조회 등)</td>
    </tr>
  </tbody>
</table>

\* 다건 주문 생성 및 취소 API는 초당 최대 20회까지 요청이 가능합니다.

<br />

## 제한 초과 시 동작

IP 주소에서 특정 API 분류 항목의 요청 수 제한을 초과하면 해당 항목의 API 사용이 일시적으로 제한됩니다.

1. 제한이 해제될 때까지 잠시 기다린 후 다시 요청하세요.
2. 요청 간격을 일정하게 분산하면 제한에 걸릴 가능성을 줄일 수 있습니다. 한 번에 대량의 요청을 보내는 대신, 일정한 간격으로 호출하는 것을 권장합니다.

## 유의사항

* 동일 가상자산에 대해 짧은 시간 동안 **과도한 주문 및 취소를 요청할 경우**(예: 초당 20회 초과) 이용이 제한될 수 있습니다.
* 사용자 급증 등 과도한 트래픽이 발생하면 안정적인 서비스 제공을 위해 **별도 공지 없이** API 요청량을 제한하거나 하향 조정할 수 있습니다.
* API 사용 제한이 자동으로 해제되지 않으면 **고객센터(1661-5566)** 로 문의하세요.