Skip to content

Latest commit

 

History

History
103 lines (77 loc) · 9.05 KB

interface_limitation.md

File metadata and controls

103 lines (77 loc) · 9.05 KB

English | 中文

HTTP interface restrictions

1. Frequency Limits

Plan Individual request Request multiple HTTP interfaces
Free /kline API：1 request per 10 seconds
/batch-kline API：1 request per 10 seconds
/depth-tick API：1 request per second
/trade-tick API：1 request per second
/static_info API：1 request per 10 seconds		 1、One request per second.
2、/batch-kline needs 10-second intervals.
3、Total of 10 requests per minute (every 6 seconds).
4、Max 14400 daily requests; excess resets at midnight.
Basic /kline API：1 request per second
/batch-kline API：1 request every 3 seconds
/depth-tick API：1 request per second
/trade-tick API：1 request per second
/static_info API：1 request per second		 1、One request per second.
2、/batch-kline: 1 request every 3 seconds.
3、Total of 60 requests per minute (1 request per second).
4、Max 86400 daily requests; excess resets at midnight.
Premium /kline API：Max 10 requests per second
/batch-kline API：1 request every 2 seconds
/depth-tick API：Max 10 requests per second
/trade-tick API：Max 10 requests per second
/static_info API：Max 10 requests per second		 1、Combined interfaces: 10 requests/second.
2、/batch-kline: 1 request/2 seconds.
3、Total: 600 requests/minute (10/second).
4、Daily limit: 864,000 requests; reset daily at midnight if exceeded.
Professional /kline API：Max 20 requests per second
/batch-kline API：1 request per second
/depth-tick API：Max 20 requests per second
/trade-tick API：Max 20 requests per second
/static_info API：Max 20 requests per second		 1、Combined interfaces: 20 requests/second.
2、/batch-kline: 1 request/second interval.
3、Total: 1200 requests/minute (20/second).
4、Daily limit: 1,728,000 requests; reset daily at midnight if exceeded.
All HK Stocks /kline API：Max 20 requests per second
/batch-kline API：1 request per second
/depth-tick API：Max 20 requests per second
/trade-tick API：Max 20 requests per second
/static_info API：Max 20 requests per second		 1、Combined interfaces: 20 requests/second.
2、/batch-kline: 1 request/second interval.
3、Total: 1200 requests/minute (20/second).
4、Daily limit: 1,728,000 requests; reset daily at midnight if exceeded.
All CN Stocks /kline API：Max 20 requests per second
/batch-kline API：1 request per second
/depth-tick API：Max 20 requests per second
/trade-tick API：Max 20 requests per second
/static_info API：Max 20 requests per second		 1、Combined interfaces: 20 requests/second.
2、/batch-kline: 1 request/second interval.
3、Total: 1200 requests/minute (20/second).
4、Daily limit: 1,728,000 requests; reset daily at midnight if exceeded.

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 1,000 K-line records can be returned per request.
  • If more than 1,000 records are requested, only the first 1,000 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.
Plan Max code requests for /batch-kline interface.
Free 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.
Basic Each request can retrieve a maximum of 100 data sets, calculated as 100 = product code count * candlestick types.
Premium Each request can retrieve a maximum of 200 data sets, calculated as 200 = product code count * candlestick types.
Professional Each request can retrieve a maximum of 500 data sets, calculated as 500 = product code count * candlestick types.
All HK Stocks Each request can fetch up to 500 data sets, calculated as 500 = product codes * candlestick types.
All CN Stocks Each request can fetch a maximum of 500 data sets, where 500 = number of product codes * types of K-line patterns.

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.
Plan Maximum requested code quantity
Free Each request can fetch up to 5 codes.
Basic Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.
Premium Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.
Professional Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.
All HK Stocks Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.
All CN Stocks Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.

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.
Text Text
Free Each request can fetch up to 5 codes.
Basic Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.
Premium Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.
Professional Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.
All HK Stocks Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.
All CN Stocks Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.

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.
Plan Maximum requested code quantity
Free Each request can fetch up to 5 codes.
Basic Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.
Premium Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.
Professional Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.
All HK Stocks Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.
All CN Stocks Due to the GET request URL length limit, it is recommended to request a maximum of 50 codes at a time.

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

Official website: https://alltick.co/