资金费扣费历史

接口描述

查询已认证用户的资金费结算历史，每条记录对应一笔仓位在某个资金费周期内的结算。

HTTP 请求

GET /fapi/v1/fundingFeeHistory (HMAC SHA256)

请求权重

5

请求参数

名称	类型	是否必需	描述
symbol	STRING	NO	交易对过滤
startTime	LONG	NO	起始时间（毫秒）
endTime	LONG	NO	结束时间（毫秒）
limit	INT	NO	默认 100，最大 1000
timestamp	LONG	YES	时间戳

响应字段

字段	类型	描述
symbol	STRING	交易对
fundingRate	STRING	结算时应用的资金费率
positionSize	STRING	仓位名义规模（USD）
fundingFee	STRING	带符号的扣费：负值=支付，正值=收取
positionSide	STRING	LONG 或 SHORT
asset	STRING	结算币种（USDT）
time	LONG	结算时间戳（毫秒）
tranId	STRING	唯一结算 ID

响应示例

[
  {
    "symbol": "BTCUSDT",
    "fundingRate": "0.0001",
    "positionSize": "60000.00",
    "fundingFee": "-6.00",
    "positionSide": "LONG",
    "asset": "USDT",
    "time": 1776060000000,
    "tranId": "550e8400-e29b-41d4-a716-446655440000"
  }
]

结果按 time 降序返回。

代码示例

cURL

API_KEY="your_api_key"
API_SECRET="your_api_secret"
TIMESTAMP=$(date +%s%3N)
QUERY_STRING="symbol=BTCUSDT&limit=100&timestamp=${TIMESTAMP}"
SIGNATURE=$(echo -n "${QUERY_STRING}" | openssl dgst -sha256 -hmac "${API_SECRET}" | awk '{print $2}')

curl -s -H "X-MBX-APIKEY: ${API_KEY}" \
  "https://api.ztdx.io/fapi/v1/fundingFeeHistory?${QUERY_STRING}&signature=${SIGNATURE}"

Python

import time, hmac, hashlib, requests

API_KEY = "your_api_key"
API_SECRET = "your_api_secret"
BASE_URL = "https://api.ztdx.io"

def sign(params: str) -> str:
    return hmac.new(API_SECRET.encode(), params.encode(), hashlib.sha256).hexdigest()

def signed_get(path, params={}):
    params["timestamp"] = int(time.time() * 1000)
    qs = "&".join(f"{k}={v}" for k, v in params.items())
    params["signature"] = sign(qs)
    return requests.get(f"{BASE_URL}{path}", params=params, headers={"X-MBX-APIKEY": API_KEY})

resp = signed_get("/fapi/v1/fundingFeeHistory", params={"symbol": "BTCUSDT", "limit": "100"})
print(resp.json())