> ## Documentation Index
> Fetch the complete documentation index at: https://alltick.co/apis/llms.txt
> Use this file to discover all available pages before exploring further.

# GET Order Book (Latest Depth / Order Book) Query

> This documentation describes AllTick’s GET latest order book quotation API for stocks, which provides real-time bid-ask quotes and multi-level order book depth for US, Hong Kong, and China A-share markets, including full request URL, parameters, response fields, and frequency limits, enabling quant trading systems, market making engines, and terminals to integrate live order book data.

[▶ Debug API](https://alltick.co/apis/apis/en/api-reference/stock/debug/depth-tick.md)

## GET /depth-tick

## Interface Description

The following is the maximum order book depth for each product type:

1. For inactive products, the available depth may be smaller than the maximum listed below. This is normal.
2. One side of the order book may be empty. For example, when a stock reaches its limit up or limit down price, one side of the order book may be empty.

| Item | Forex, Precious Metals, Crude Oil | Cryptocurrencies | Hong Kong Stocks | US Stocks | A Shares |
| - | - | - | - | - | - |
| Depth Description | Up to 1 level | Up to 5 levels | Up to 10 levels | Up to 1 level | Up to 5 levels |

## Request Frequency

| Plan | Individual Request | Multiple HTTP Interfaces Requested Together |
| - | - | - |
| Free | One request every 10 seconds | 1. Only one interface request every 10 seconds. **2. When requesting multiple interfaces, note that /batch-kline requires a 10-second interval.** 3. All interfaces combined: maximum 10 requests per minute (one every 6 seconds). 4. Maximum 1,000 requests per day; usage resumes after midnight the next day if exceeded. |
| Basic | One request per second | 1. Only one interface request in the same second. **2. When requesting multiple interfaces, note that /batch-kline requires a 3-second interval.** 3. All interfaces combined: maximum 60 requests per minute (one per second). 4. Maximum 86,400 requests per day; usage resumes after midnight the next day if exceeded. |
| Premium | Up to 10 requests per second | 1. All interfaces combined: up to 10 requests per second. **2. When requesting multiple interfaces, note that /batch-kline requires a 2-second interval.** 3. All interfaces combined: maximum 600 requests per minute (10 per second). 4. Maximum 864,000 requests per day; usage resumes after midnight the next day if exceeded. |
| Professional | Up to 20 requests per second | 1. All interfaces combined: up to 20 requests per second. **2. When requesting multiple interfaces, note that /batch-kline requires a 1-second interval.** 3. All interfaces combined: maximum 1,200 requests per minute (20 per second). 4. Maximum 1,728,000 requests per day; usage resumes after midnight the next day if exceeded. |
| All Hong Kong Stocks | Up to 20 requests per second | 1. All interfaces combined: up to 20 requests per second. **2. When requesting multiple interfaces, note that /batch-kline requires a 1-second interval.** 3. All interfaces combined: maximum 1,200 requests per minute (20 per second). 4. Maximum 1,728,000 requests per day; usage resumes after midnight the next day if exceeded. |
| All A Shares | Up to 20 requests per second | 1. All interfaces combined: up to 20 requests per second. **2. When requesting multiple interfaces, note that /batch-kline requires a 1-second interval.** 3. All interfaces combined: maximum 1,200 requests per minute (20 per second). 4. Maximum 1,728,000 requests per day; usage resumes after midnight the next day if exceeded. |
| All US Stocks | Up to 20 requests per second | 1. All interfaces combined: up to 20 requests per second. **2. When requesting multiple interfaces, note that /batch-kline requires a 1-second interval.** 3. All interfaces combined: maximum 1,200 requests per minute (20 per second). 4. Maximum 1,728,000 requests per day; usage resumes after midnight the next day if exceeded. |

## Interface Limitations

1. Be sure to read: [HTTP Interface Restrictions](https://alltick.co/apis/apis/en/getting-started/http-interface-restrictions.md)
2. Be sure to read: [Error Code Description](https://alltick.co/apis/apis/en/getting-started/error-code-description.md)

## API Endpoints

**1. US Stocks, Hong Kong Stocks, A Shares, and Major Index Data:**

* Base Path: `/quote-stock-b-api/depth-tick`
* Full URL: [[https://quote.alltick.co/quote-stock-b-api/depth-tick](https://quote.alltick.co/quote-stock-b-api/depth-tick)](https://quote.alltick.co/quote-stock-b-api/depth-tick)

**2. Forex, Precious Metals, Cryptocurrencies, Crude Oil, CFD Indices, and Commodities:**

* Base Path: `/quote-b-api/depth-tick`
* Full URL: [[https://quote.alltick.co/quote-b-api/depth-tick](https://quote.alltick.co/quote-b-api/depth-tick)](https://quote.alltick.co/quote-b-api/depth-tick)

## Request Examples

**1. US Stocks, Hong Kong Stocks, A Shares, and Major Index Data:**

When sending a query request, include the method name and token information. Example:

[https://quote.alltick.co/quote-stock-b-api/depth-tick?token=your\_token\&query=queryData](https://quote.alltick.co/quote-stock-b-api/depth-tick?token=your_token\&query=queryData)

**2. Forex, Precious Metals, Cryptocurrencies, Crude Oil, CFD Indices, and Commodities:**

When sending a query request, include the method name and token information. Example:

[https://quote.alltick.co/quote-b-api/depth-tick?token=your\_token\&query=queryData](https://quote.alltick.co/quote-b-api/depth-tick?token=your_token\&query=queryData)

## Request Parameters

| Name | Position | Type | Required | Description |
| - | - | - | - | - |
| token | query | string | No | |
| query | query | string | No | See the query request parameter description. |

## Query Request Parameters

URL-encode the following JSON and assign it to the `query` query string in the URL.

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

| Name | Type | Required | Description |
| - | - | - | - |
| trace | string | Yes | |
| data | object | Yes | |
| » symbol\_list | \[object] | Yes | |
| »» code | string | No | Code. Select the code you want to query from the [code list](https://docs.google.com/spreadsheets/d/1avkeR1heZSj6gXIkDeBt8X3nv4EzJetw4yFuKjSDYtA/edit?gid=495387863#gid=495387863). **Note: The code value is case-sensitive and must match the code in the product list.** |

## Response Example

```json theme={null}
{
  "ret": 200,
  "msg": "ok",
  "trace": "edd5df80-df7f-4acf-8f67-68fd2f096426",
  "data": {
    "tick_list": [
      {
        "code": "857.HK",
        "seq": "30686349",
        "tick_time": "1677830357227",
        "bids": [
          {
            "price": "136.424",
            "volume": "100000.00"
          }
        ],
        "asks": [
          {
            "price": "136.427",
            "volume": "400000.00"
          }
        ]
      }
    ]
  }
}
```

## Response Result

| Status Code | Status Meaning | Description | Data Model |
| - | - | - | - |
| 200 | OK | OK | Inline |

| 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 | Quote sequence number |
| »»» tick\_time | string | false | Quote timestamp |
| »»» bids | \[object] | false | Bid list |
| »»»» price | string | false | Price |
| »»»» volume | string | false | Volume |
| »»» asks | \[object] | false | Ask list |
| »»»» price | string | false | Price |
| »»»» volume | string | false | Volume. 1. Some CFD indices do not provide volume. 2. Forex, precious metals, energy, stocks, and cryptocurrencies all provide volume. |

#### AllTick Website

> [!NOTE]
>
> Official website: \[[https://alltick.co/](https://alltick.co/)]\([https://alltick.co/](https://alltick.co/))


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.