GET Latest transaction price query（Latest Price）

English / 中文

GET /trade-tick

Interface Description

This interface supports batch requests for the latest trade prices (latest tick data、Latest Price) but does not support requests for historical trade prices (historical tick data).

Request Frequency

Plan	Individual request	Request multiple HTTP interfaces
Free	1、Once every 10 seconds, only 1 request can be made 2、5 products per batch max	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	1、Only 1 request per second 2、Suggest 50 code requests max due to GET URL length limit	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	1、Up to 10 requests per second 2、Suggest 50 code requests max due to GET URL length limit	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	1、Up to 20 requests per second 2、Suggest 50 code requests max due to GET URL length limit	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	1、Up to 20 requests per second 2、Suggest 50 code requests max due to GET URL length limit	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	1、Up to 20 requests per second 2、Suggest 50 code requests max due to GET URL length limit	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.

Interface Limitations

1. Please be sure to read: [ HTTP Interface Limitations ].

2. Please be sure to read: [ Error Code Descriptions ].

API Endpoints

API Endpoints

1. US Stocks, Hong Kong Stocks, A Shares, Major Index Data API Endpoints:

   • Base Path: /quote-stock-b-api/trade-tick

   • Full URL: https://quote.alltick.io/quote-stock-b-api/trade-tick

2. Forex, Precious Metals, Cryptocurrencies, Commodities API Endpoints:

   • Base Path: /quote-b-api/trade-tick

   • Full URL: https://quote.alltick.io/quote-b-api/trade-tick

Request Examples

1. Request Example for US Stocks, Hong Kong Stocks, A Shares, Major Index Data: When sending a query request, you must include the method name and token information. An example request is as follows:

   https://quote.alltick.io/quote-stock-b-api/trade-tick?token=your_token&query=queryData

2. Request Example for Forex, Precious Metals, Cryptocurrencies, Commodities: When sending a query request, you must include the method name and token information. An example request is as follows:

   https://quote.alltick.io/quote-b-api/trade-tick?token=your_token&query=queryData

Request Parameters

Name	Position	Type	Required	Description
token	query	string	No
query	query	string	No	See explanation of query request parameters below

Query Request Parameters

The following JSON should be URL-encoded and assigned to the query query string in the URL.

{
  "trace": "edd5df80-df7f-4acf-8f67-68fd2f096426",
  "data": {
    "symbol_list": [
      {
        "code": "857.HK"
      },
      {
        "code": "UNH.US"
      }
    ]
  }
}

Query Request Parameters

Name	Type	Required	Description
trace	string	Yes
data	object	Yes
» symbol_list	[object]	Yes
»» code	string	No	Code

Response Example

OK

{
  "ret": 200,
  "msg": "ok",
  "trace": "edd5df80-df7f-4acf-8f67-68fd2f096426",
  "data": {
    "tick_list": [
      {
        "code": "857.HK",
        "seq": "30841439",
        "tick_time": "1677831545217",
        "price": "136.302",
        "volume": "0",
        "turnover": "0",
        "trade_direction": 0
      }
    ]
  }
}

Response Result

Status Code	Status Meaning	Description	Data Model
200	OK	OK	Inline

Response Data Structure

Status Code 200

Name	Type	Required	Description
» ret	integer	true	Return code
» msg	string	true	Message corresponding to the return code
» trace	string	true	Request trace
» data	object	true
»» tick_list	[object]	true
»»» code	string	false	Code
»»» seq	string	false	Sequence
»»» tick_time	string	false	Timestamp
»»» price	string	false	Price
»»» volume	string	false	Volume
»»» turnover	string	false	Turnover (Trade Amount): For forex, precious metals, and energy, turnover is not returned. You can calculate it using the formula: turnover = price × volume For stocks and cryptocurrencies, turnover is provided normally.
»»» trade_direction	integer	false	Trade Direction: 0 is the default value, 1 is Buy, and 2 is Sell. For forex, precious metals, and energy, the default return is only 0. For stocks and cryptocurrencies, it can return 0, 1, or 2 based on market conditions. Detailed Explanation: 0: Neutral, indicating a trade executed at a price between the best bid and best ask. 1: Aggressive Buy, indicating a trade executed at the ask price or higher. 2: Aggressive Sell, indicating a trade executed at the bid price or lower.

Official Website

Official website: https://alltick.co/