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

# 最新盘口

### 接口说明

查询每类产品最大的盘口深度。

```http theme={null}
GET /v1/depth/{queryData}
```

| 产品类型                    | 请求地址                                                              |
| ----------------------- | ----------------------------------------------------------------- |
| 美股、港股、A股、大盘数据           | `https://quote.alltick.co/quote-stock-b-api/v1/depth/{queryData}` |
| 外汇、贵金属、加密货币、原油、CFD指数、商品 | `https://quote.alltick.co/quote-b-api/v1/depth/{queryData}`       |

### 请求参数

| 参数          | 类型     | 必填 | 说明     |
| ----------- | ------ | -- | ------ |
| `X-API-Key` | string | 是  | 身份认证令牌 |
| `queryData` | string | 是  | 请求内容   |

### queryData

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

### 返回示例

```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"}]}]
  }
}
```

### 返回字段

`tick_list` 包含 `code`、`seq`、`tick_time`、`bids` 和 `asks`；买卖盘每一档包含 `price` 和 `volume`。部分CFD指数不提供 `volume`，外汇、贵金属、能源、股票和加密货币均提供 `volume`。
