成交历史

接口描述

获取特定交易对的成交记录。

HTTP请求

GET /fapi/v1/userTrades (HMAC SHA256)

请求权重

5

请求参数

名称	类型	是否必需	描述
symbol	STRING	YES	交易对
orderId	LONG	NO	系统订单 ID
startTime	LONG	NO	起始时间
endTime	LONG	NO	结束时间
fromId	LONG	NO	起始成交 ID
limit	INT	NO	默认 500; 最大 1000
timestamp	LONG	YES	时间戳

响应示例

[
  {
    "symbol": "BTCUSDT",
    "id": 677430,
    "orderId": 812318,
    "side": "BUY",
    "price": "6921.00",
    "qty": "1.000",
    "quoteQty": "6921.00",
    "realizedPnl": "-0.01503",
    "marginAsset": "USDT",
    "commission": "0.00000000",
    "commissionAsset": "USDT",
    "time": 1569069506613,
    "buyer": true,
    "maker": false
  }
]

只能查询最近3个月的成交历史。

代码示例

cURL

API_KEY="your_api_key"
API_SECRET="your_api_secret"
TIMESTAMP=$(date +%s%3N)
QUERY_STRING="symbol=BTCUSDT&limit=500&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-sepolia.ztdx.io/fapi/v1/userTrades?${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})

# Get user trades for BTCUSDT
resp = signed_get("/fapi/v1/userTrades", params={
    "symbol": "BTCUSDT",
    "limit": "500"
})
print(resp.json())