跳到主要内容

持仓总量历史统计

接口描述​

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

HTTP请求​

GET /futures/data/openInterestHist

请求参数​

名称类型是否必需描述
symbolSTRINGYES交易对
periodENUMNO"5m","15m","30m","1h","2h","4h","6h","12h","1d"; 默认 "5m"
limitINTNO默认 30; 最大 500
startTimeLONGNO已接受但当前忽略
endTimeLONGNO已接受但当前忽略

sumOpenInterest 与 sumOpenInterestValue 当前返回相同的持仓总额(USD)。

响应示例​

[
  {
    "symbol": "BTCUSDT",
    "sumOpenInterest": "150570701.18",      // 持仓总额(USD)
    "sumOpenInterestValue": "150570701.18", // 持仓总额(USD, 与 sumOpenInterest 相同)
    "timestamp": "1583127600000"           // 时间戳(字符串)
  }
]

代码示例​

cURL​

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

Python​

import requests

base_url = "https://api.prex.world"
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']}")