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

# 获取深度

`获取交易对完整的深度。`

#### 请求URL

`GET https://cloud-api.wooxpro.com/contract/public/depth`

#### 请求限制

参见 [速率限制详细](/cn/rate-limit)

#### 请求参数

> 请求

```shell theme={null}
curl https://cloud-api.wooxpro.com/contract/public/depth?symbol=BTCUSDT
```

| 参数     | 类型     | 是否必填 | 描述              |
| :----- | :----- | :--- | :-------------- |
| symbol | String | 必填   | 合约交易对（如BTCUSDT） |

#### 响应详情

> 响应

```json theme={null}
{
  "code": 1000,
  "message": "Ok",
  "trace": "b9bff62d-9ac8-4815-8808-8f745673c096",
  "data": {
    "asks": [
      [
        "23935.4",
        "65",
        "65"
      ]
    ],
    "bids": [
      [
        "23935.4",
        "65",
        "65"
      ]
    ],
    "timestamp": 1660285421287,
    "symbol": "BTCUSDT"
  }
}
```

| 字段        | 类型     | 描述                |
| :-------- | :----- | :---------------- |
| timestamp | Long   | 当前系统时间(时间戳，精确到毫秒) |
| bids      | List   | 买方深度列表            |
| asks      | List   | 卖方深度列表            |
| symbol    | String | 交易对               |

<aside class="notice">
  最多返回 50 条数据。
</aside>

深度详情描述：

| 字段  | 类型     | 描述                        |
| :-- | :----- | :------------------------ |
| 第一位 | String | 当前深度价格。例如 23935.4         |
| 第二位 | String | 当前价格深度的总量。例如 65           |
| 第三位 | String | 当前价格深度之上（包含当前）的总量累加。例如 65 |