调用函数查询BTCUSDT的24小时ticker数据

实战：使用币安Web3 API查询期货持仓量

下面，我们将以常见的编程语言Python为例,展示如何调用上述API获取期货持仓量数据。

准备工作：获取API密钥（可选，对于公开数据无需）

对于/fapi/v1/ticker/24hr和/fapi/v1/openInterest这类公开的市场数据接口，通常不需要API密钥即可调用，但如果需要调用更高频率或有访问限制的接口，或者进行交易操作，则需要在币安官网（https://www.binance.com/）创建API并获取API Key和Secret。

示例1：查询特定交易对（如BTCUSDT）的24小时持仓量及变化

我们将使用requests库调用/fapi/v1/ticker/24hr接口。

import requests
import json
def get_24hr_ticker(symbol="BTCUSDT"):
    url = "https://fapi.binance.com/fapi/v1/ticker/24hr"
    params = {"symbol": symbol}
    try:
        response = requests.get(url, params=params)
        response.raise_for_status()  # 检查请求是否成功
        data = response.json()
        if data:
            print(f"交易对: {data['symbol']}")
            print(f"当前持仓量 (Open Interest): {float(data['openInterest']):,.2f} {data['symbol'][-4:]}")  # 假设计价资产是USDT等
            print(f"24小时持仓量变化: {data['openInterestPercent']}%")  # 币安提供的24h持仓量变化百分比
            print(f"24小时成交量: {float(data['volume']):,.2f} {data['symbol'][:-4]}")
        else:
            print("未找到相关数据，请检查交易对是否正确。")
    except requests.exceptions.RequestException as e:
        print(f"请求发生错误: {e}")
get_24hr_ticker("BTCUSDT")

代码说明:

• 我们构造了API的URL，并传入symbol参数指定交易对。
• 使用requests.get()发送GET请求。
• 解析返回的JSON数据，提取openInterest（当前持仓量）和openInterestPercent（24小时持仓量变化百分比）。

示例2：查询特定交易对（如ETHUSDT）的当前实时持仓量

我们将调用专门的/fapi/v1/openInterest接口。

import requests
import json
def get_current_open_interest(symbol="ETHUSDT"):
    url = "https://fapi.binance.com/fapi/v1/openInterest"
    params = {"symbol": symbol}
    try:
        response = requests.get(url, params=params)
        response.raise_for_status()
        data = response.json()
        if data:
            print(f"交易对: {data['symbol']}")
            print(f"当前持仓量 (Open Interest): {float(data['openInterest']):,.2f} {data['symbol'][-4:]}")
            print(f"时间戳: {data['time']}")
        else:
            print("未找到相关数据，请检查交易对是否正确。")
    except requests.exceptions.RequestException as e:
        print(f"请求发生错误: {e}")
# 调用函数查询ETHUSDT的当前持仓量
get_current_open_interest("ETHUSDT")

代码说明:

• 此接口更专注于持仓量,返回的数据相对简洁。
• openInterest字段即为当前最新的持仓量。
• time字段是数据生成的时间戳。

示例3：获取所有USDT永续合约的当前持仓量（分页处理）

如果需要获取所有交易对的持仓量，可以不传symbol参数，但需要注意返回数据量可能较大,币安API通常会分页返回。

import requests
import json
def get_all_open_interest(limit=500):
    url = "https://fapi.binance.com/fapi/v1/openInterest"
    params = {"limit": limit}  # 限制返回数量，最大1000
    try:
        response = requests.get(url, params=params)
        response.raise_for_status()
        data = response.json()
        if data:
            print(f"获取前 {len(data)} 个交易对的持仓量：")
            for item in data:
                print(f"{item['symbol']}: {float(item['openInterest']):,.2f} USDT")
        else:
            print("未获取到数据。")
    except requests.exceptions.RequestException as e:
        print(f"请求发生错误: {e}")
# 调用函数获取所有USDT永续合约的当前持仓量（前500个）
get_all_open_interest()

使用WebSocket API获取实时持仓量更新

对于需要实时监控持仓量变化的场景，使用WebSocket API会比轮询REST API更高效,币安提供了期货持仓量的WebSocket数据流。

示例：连接币安期货WebSocket并订阅BTCUSDT的持仓量更新

import websockets
import json
import asyncio
async def binance_futures_oi_stream():
    uri = "wss://fstream.binance.com/ws"
    symbol = "btcusdt@openInterest"  # 订阅BTCUSDT的持仓量
    try:
        async with websockets.connect(uri) as websocket:
            print(f"已连接到币安期货WebSocket，订阅 {symbol}")
            await websocket.send(json.dumps({"method": "SUBSCRIBE", "params": [symbol], "id": 1}))
            while True:
                response = await websocket.recv()
                data = json.loads(response)
                if 'data' in data and data['data']:
                    oi_data = data['data']
                    print(f"时间戳: {oi_data['E']}, 交易对: {oi_data['s']}, 持仓量: {float(oi_data['o']):,.2f