持仓总量历史统计

接口描述

获取各个交易对的持仓总量历史统计数据。

HTTP请求

GET /futures/data/openInterestHist

请求权重

1

请求参数

名称	类型	是否必需	描述
symbol	STRING	YES	交易对
period	ENUM	YES	"5m","15m","30m","1h","2h","4h","6h","12h","1d"
limit	INT	NO	默认 30; 最大 500
startTime	LONG	NO	起始时间
endTime	LONG	NO	结束时间

响应示例

[
  {
    "symbol": "BTCUSDT",
    "sumOpenInterest": "20403.473",        // 持仓总量
    "sumOpenInterestValue": "150570701.18", // 持仓总额
    "timestamp": 1583127600000            // 时间
  }
]

代码示例

cURL

curl -s "https://api-sepolia.ztdx.io/futures/data/openInterestHist?symbol=BTCUSDT&period=1h&limit=5"

Python

import requests

base_url = "https://api.ztdx.io"
params = {"symbol": "BTCUSDT", "period": "1h", "limit": 5}
response = requests.get(f"{base_url}/futures/data/openInterestHist", params=params)
for record in response.json():
    print(f"{record['symbol']}: OI={record['sumOpenInterest']} ts={record['timestamp']}")