跳到主要内容

主买/主卖成交量

接口描述​

获取各个交易对的主买/主卖成交量。

HTTP请求​

GET /futures/data/takerlongshortRatio

请求参数​

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

buyVol 与 sellVol 是以 USD 计的名义价值(每个时间桶内 price × amount 之和)，而不是标的资产数量。

响应示例​

[
  {
    "buySellRatio": "0.1979",         // 主买/主卖比例
    "sellVol": "848.243",           // 主卖名义成交额(USD)
    "buyVol": "167.854",            // 主买名义成交额(USD)
    "timestamp": "1583127600000"     // 时间戳(字符串)
  }
]

代码示例​

cURL​

curl -s "https://api.prex.world/futures/data/takerlongshortRatio?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/takerlongshortRatio", params=params)
for record in response.json():
    print(f"Ratio={record['buySellRatio']} Buy={record['buyVol']} Sell={record['sellVol']}")