> For the complete documentation index, see [llms.txt](https://en.apis.alltick.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://en.apis.alltick.co/integration-process/interface-restriction-description/http-interface-restrictions.md).

# 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="/pages/8AjgVh4UO2uHZDxUzKK7">[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="/pages/8AjgVh4UO2uHZDxUzKK7">[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="/pages/8AjgVh4UO2uHZDxUzKK7">[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="/pages/8AjgVh4UO2uHZDxUzKK7">[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="/pages/8AjgVh4UO2uHZDxUzKK7">[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="/pages/GFWQMttc5hcqPRIZJK2p">[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="/pages/GFWQMttc5hcqPRIZJK2p">[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="/pages/GFWQMttc5hcqPRIZJK2p">[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="/pages/GFWQMttc5hcqPRIZJK2p">[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="/pages/GFWQMttc5hcqPRIZJK2p">[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 %}