> ## 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/open-interest`

#### 请求限制

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

#### 请求参数

> 请求

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

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

#### 响应详情

> 响应

```json theme={null}
{
  "code": 1000,
  "trace": "0cc6f4c4-8b8c-4253-8e90-8d3195aa109c",
  "message": "Ok",
  "data": {
    "timestamp": 1661239541734,
    "symbol": "BTCUSDT",
    "open_interest": "4134180870",
    "open_interest_value": "94100888927.0433258"
  }
}
```

| 字段                    | 类型     | 描述    |
| :-------------------- | :----- | :---- |
| timestamp             | Long   | 时间戳   |
| symbol                | String | 合约名称  |
| open\_interest        | String | 持仓量   |
| open\_interest\_value | String | 持仓量价值 |