# HTTP interface restrictions

English / [中文](https://apis.alltick.co/jie-ru-liu-cheng/jie-kou-xian-zhi-shuo-ming/http-jie-kou-xian-zhi)

## HTTP interface restrictions

### **1.** Frequency Limits

<table data-full-width="false"><thead><tr><th width="121.3984375">Plan</th><th width="328.31640625">Individual request</th><th width="332">Request multiple HTTP interfaces</th></tr></thead><tbody><tr><td>Free</td><td><strong>/kline API：</strong>1 request per 10 seconds<br><strong>/batch-kline API：</strong>1 request per 10 seconds<br><strong>/depth-tick API：</strong>1 request per 10 seconds<br><strong>/trade-tick API：</strong>1 request per 10 seconds<br><strong>/static_info API：</strong>1 request per 10 seconds<br><br><strong>/api/suspension/sse API</strong>：1 request per minute<br><strong>/api/suspension/nyse  API</strong>：1 request per minute<br><strong>/api/suspension/nasdaq API</strong>：1 request per minute</td><td><p>1、1 request per 10 seconds.</p><p>2、/batch-kline needs 10-second intervals.</p><p>3、Total of 10 requests per minute (every 6 seconds).</p><p>4、Max 1000 daily requests; excess resets at midnight.</p></td></tr><tr><td>Basic</td><td><strong>/kline API：</strong>1 request per second<br><strong>/batch-kline API：</strong>1 request every 3 seconds<br><strong>/depth-tick API：</strong>1 request per second<br><strong>/trade-tick API：</strong>1 request per second<br><strong>/static_info API：</strong>1 request per second<br><br><strong>/api/suspension/sse API</strong>：1 request per minute<br><strong>/api/suspension/nyse  API</strong>：1 request per minute<br><strong>/api/suspension/nasdaq API</strong>：1 request per minute</td><td><p>1、One request per second.</p><p>2、/batch-kline: 1 request every 3 seconds.</p><p>3、Total of 60 requests per minute (1 request per second).</p><p>4、Max 86400 daily requests; excess resets at midnight.</p></td></tr><tr><td>Premium</td><td><strong>/kline API：</strong>Max 10 requests per second<br><strong>/batch-kline API：</strong>1 request every 2 seconds<br><strong>/depth-tick API：</strong>Max 10 requests per second<br><strong>/trade-tick API：</strong>Max 10 requests per second<br><strong>/static_info API：</strong>Max 10 requests per second<br><br><strong>/api/suspension/sse API</strong>：1 request per minute<br><strong>/api/suspension/nyse  API</strong>：1 request per minute<br><strong>/api/suspension/nasdaq API</strong>：1 request per minute</td><td><p>1、Combined interfaces: 10 requests/second.</p><p>2、/batch-kline: 1 request/2 seconds.</p><p>3、Total: 600 requests/minute (10/second).</p><p>4、Daily limit: 864,000 requests; reset daily at midnight if exceeded.</p></td></tr><tr><td>Professional</td><td><strong>/kline API：</strong>Max 20 requests per second<br><strong>/batch-kline API：</strong>1 request per second<br><strong>/depth-tick API：</strong>Max 20 requests per second<br><strong>/trade-tick API：</strong>Max 20 requests per second<br><strong>/static_info API：</strong>Max 20 requests per second<br><br><strong>/api/suspension/sse API</strong>：1 request per minute<br><strong>/api/suspension/nyse  API</strong>：1 request per minute<br><strong>/api/suspension/nasdaq API</strong>：1 request per minute</td><td><p>1、Combined interfaces: 20 requests/second.</p><p>2、/batch-kline: 1 request/second interval.</p><p>3、Total: 1200 requests/minute (20/second).</p><p>4、Daily limit: 1,728,000 requests; reset daily at midnight if exceeded.</p></td></tr><tr><td>All HK Stocks</td><td><strong>/kline API：</strong>Max 20 requests per second<br><strong>/batch-kline API：</strong>1 request per second<br><strong>/depth-tick API：</strong>Max 20 requests per second<br><strong>/trade-tick API：</strong>Max 20 requests per second<br><strong>/static_info API：</strong>Max 20 requests per second<br><br><strong>/api/suspension/sse API</strong>：1 request per minute<br><strong>/api/suspension/nyse  API</strong>：1 request per minute<br><strong>/api/suspension/nasdaq API</strong>：1 request per minute</td><td><p>1、Combined interfaces: 20 requests/second.</p><p>2、/batch-kline: 1 request/second interval.</p><p>3、Total: 1200 requests/minute (20/second).</p><p>4、Daily limit: 1,728,000 requests; reset daily at midnight if exceeded.</p></td></tr><tr><td>All CN Stocks</td><td><strong>/kline API：</strong>Max 20 requests per second<br><strong>/batch-kline API：</strong>1 request per second<br><strong>/depth-tick API：</strong>Max 20 requests per second<br><strong>/trade-tick API：</strong>Max 20 requests per second<br><strong>/static_info API：</strong>Max 20 requests per second<br><br><strong>/api/suspension/sse API</strong>：1 request per minute<br><strong>/api/suspension/nyse  API</strong>：1 request per minute<br><strong>/api/suspension/nasdaq API</strong>：1 request per minute</td><td><p>1、Combined interfaces: 20 requests/second.</p><p>2、/batch-kline: 1 request/second interval.</p><p>3、Total: 1200 requests/minute (20/second).</p><p>4、Daily limit: 1,728,000 requests; reset daily at midnight if exceeded.</p></td></tr><tr><td>All US Stocks</td><td><strong>/kline API：</strong>Max 20 requests per second<br><strong>/batch-kline API：</strong>1 request per second<br><strong>/depth-tick API：</strong>Max 20 requests per second<br><strong>/trade-tick API：</strong>Max 20 requests per second<br><strong>/static_info API：</strong>Max 20 requests per second<br><br><strong>/api/suspension/sse API</strong>：1 request per minute<br><strong>/api/suspension/nyse  API</strong>：1 request per minute<br><strong>/api/suspension/nasdaq API</strong>：1 request per minute</td><td><p>1、Combined interfaces: 20 requests/second.</p><p>2、/batch-kline: 1 request/second interval.</p><p>3、Total: 1200 requests/minute (20/second).</p><p>4、Daily limit: 1,728,000 requests; reset daily at midnight if exceeded.</p></td></tr></tbody></table>

### **2.** IP Limits

* Requests are limited based on the token, not the IP address.
* Example:：
  * The basic plan allows **1 request per second**.
  * If a token requests the `/kline` API at **14:03:01** and the `/trade-tick` API within the same second, both will be processed.
  * However, if the token sends **two requests** to `/kline` at **14:03:01**, the first will succeed, but the second will be rejected.

### **3.** K-Line Data Query Limits

* **`/kline` API**:
  * Queries must specify **one product code** per request.
  * A maximum of 5**00 K-line records** can be returned per request.
  * If more than 5**00** records are requested, only the first 5**00** will be returned.
* **`/batch-kline` API**:
  * Supports multiple product codes per request.
  * The number of codes allowed depends on the purchased plan.
  * Each request returns up to **2 K-line records per code**.
  * If more than 2 records are requested, only the first 2 will be returned.

<table><thead><tr><th width="176">Plan</th><th>Max code requests for /batch-kline interface.</th></tr></thead><tbody><tr><td>Free</td><td>Each request can fetch up to 5 data sets, calculated as 5=product code count * candlestick types. Candlestick types include 1-minute, 15-minute, etc.</td></tr><tr><td>Basic</td><td>Each request can retrieve a maximum of 100 data sets, calculated as 100 = product code count * candlestick types.</td></tr><tr><td>Premium</td><td>Each request can retrieve a maximum of 200 data sets, calculated as 200 = product code count * candlestick types.</td></tr><tr><td>Professional</td><td>Each request can retrieve a maximum of 500 data sets, calculated as 500 = product code count * candlestick types.</td></tr><tr><td>All HK Stocks</td><td>Each request can fetch up to 500 data sets, calculated as 500 = product codes * candlestick types. </td></tr><tr><td>All CN Stocks</td><td>Each request can fetch a maximum of 500 data sets, where 500 = number of product codes * types of K-line patterns.</td></tr></tbody></table>

### **4.** Latest Trade Price Query Limits

* **`/trade-tick` API**:
  * Allows querying the latest trade prices for multiple product codes in a single request.
  * The number of product codes that can be queried at once depends on the purchased plan (see the table below).
  * If the request exceeds the allowed number of product codes, the system will only process and return results for the first **N** codes within the limit.

<table><thead><tr><th width="227">Plan</th><th>Maximum requested code quantity</th></tr></thead><tbody><tr><td>Free</td><td>Each request can fetch up to 5 codes. </td></tr><tr><td>Basic</td><td>Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.<br>Use the WebSocket interface for batch subscriptions of more codes: <a href="../../websocket-api/websocket-interface-api/transaction-quote-subscription">[Interface]</a></td></tr><tr><td>Premium</td><td>Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.<br>Use the WebSocket interface for batch subscriptions of more codes: <a href="../../websocket-api/websocket-interface-api/transaction-quote-subscription">[Interface]</a></td></tr><tr><td>Professional</td><td>Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.<br>Use the WebSocket interface for batch subscriptions of more codes: <a href="../../websocket-api/websocket-interface-api/transaction-quote-subscription">[Interface]</a></td></tr><tr><td>All HK Stocks</td><td>Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.<br>Use the WebSocket interface for batch subscriptions of more codes: <a href="../../websocket-api/websocket-interface-api/transaction-quote-subscription">[Interface]</a></td></tr><tr><td>All CN Stocks</td><td>Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.<br>Use the WebSocket interface for batch subscriptions of more codes: <a href="../../websocket-api/websocket-interface-api/transaction-quote-subscription">[Interface]</a></td></tr></tbody></table>

### **5.** Order Book Query Limits

* **`/depth-tick` API**:
  * Supports multiple product codes per request.
  * The number of codes allowed depends on the purchased plan.
  * If more codes are requested than allowed, only the first **N** will be processed.

<table><thead><tr><th width="221">Plan</th><th>Maximum requested code quantity</th></tr></thead><tbody><tr><td>Free</td><td>Each request can fetch up to 5 codes. </td></tr><tr><td>Basic</td><td>Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.<br>Use the WebSocket interface for batch subscriptions of more codes: <a href="../../websocket-api/websocket-interface-api/handicap-quote-subscription">[Interface]</a></td></tr><tr><td>Premium</td><td>Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.<br>Use the WebSocket interface for batch subscriptions of more codes: <a href="../../websocket-api/websocket-interface-api/handicap-quote-subscription">[Interface]</a></td></tr><tr><td>Professional</td><td>Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.<br>Use the WebSocket interface for batch subscriptions of more codes: <a href="../../websocket-api/websocket-interface-api/handicap-quote-subscription">[Interface]</a></td></tr><tr><td>All HK Stocks</td><td>Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.<br>Use the WebSocket interface for batch subscriptions of more codes: <a href="../../websocket-api/websocket-interface-api/handicap-quote-subscription">[Interface]</a></td></tr><tr><td>All CN Stocks</td><td>Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.<br>Use the WebSocket interface for batch subscriptions of more codes: <a href="../../websocket-api/websocket-interface-api/handicap-quote-subscription">[Interface]</a></td></tr></tbody></table>

### **6.** Basic Information Query Limits

* **`/static_info` API**:
  * Supports multiple product codes per request.
  * The number of codes allowed depends on the purchased plan.
  * If more codes are requested than allowed, only the first **N** will be processed.

<table><thead><tr><th width="221">Plan</th><th>Maximum requested code quantity</th></tr></thead><tbody><tr><td>Free</td><td>Each request can fetch up to 5 codes. </td></tr><tr><td>Basic</td><td>Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.</td></tr><tr><td>Premium</td><td>Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.</td></tr><tr><td>Professional</td><td>Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.</td></tr><tr><td>All HK Stocks</td><td>Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.</td></tr><tr><td>All CN Stocks</td><td>Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.</td></tr></tbody></table>

#### Important Notes

* Plan your API requests efficiently to avoid service interruptions.
* These limits ensure fair resource distribution and system stability.
* For further assistance, please contact customer support.

***

### Official Website

{% hint style="info" %}
Official website: <https://alltick.co/>
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://en.apis.alltick.co/integration-process/interface-restriction-description/http-interface-restrictions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.