> ## 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.

# Latest order book

### Endpoint description

Query the maximum available order-book depth for each product type.

```http theme={null}
POST /v1/depth
```

| Product type | Request URL |
| - | - |
| US stocks, Hong Kong stocks, A-shares, and major indices | `https://quote.alltick.co/quote-stock-b-api/v1/depth` |
| Forex, precious metals, cryptocurrencies, crude oil, CFD indices, and commodities | `https://quote.alltick.co/quote-b-api/v1/depth` |

### Request parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `X-API-Key` | string | Yes | Authentication token in the request header |
| `body` | string | Yes | JSON request content |

### Request body

```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 | Request trace ID |
| `data` | object | Yes | Request data |
| `symbol_list` | array | Yes | Product list |
| `code` | string | No | Product code; case must match 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 fields

`tick_list` contains `code`, `seq`, `tick_time`, `bids`, and `asks`; each bid or ask level has `price` and `volume`. Some CFD indices do not provide `volume`; forex, precious metals, energy, stocks, and cryptocurrencies do.


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