跳到主要内容

成交历史

接口描述​

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

HTTP请求​

GET /fapi/v1/userTrades (HMAC SHA256)

请求参数​

名称类型是否必需描述
symbolSTRINGYES交易对
orderIdSTRINGNO系统订单 ID（UUID）—— 将结果限定为某一笔订单的成交
startTimeLONGNO起始时间（毫秒）
endTimeLONGNO结束时间（毫秒）
fromIdLONGNO毫秒时间戳下界 —— 只返回在该时间及之后执行的成交。这不是成交 ID 游标：成交 ID 是 UUID，无法按数字翻页。
limitINTNO默认 500; 最大 1000
timestampLONGYES时间戳

没有时间截止 —— 更早的成交仍然可查。

响应示例​

[
  {
    "symbol": "BTCUSDT",
    "id": "0fbb7679-7960-41b1-8025-054450129024",
    "orderId": "b8bab68c-d41b-462b-8a9e-d451ac1e1665",
    "side": "BUY",
    "price": "6921.00",
    "qty": "1.000",
    "quoteQty": "6921.00",
    "realizedPnl": "-0.01503",
    "commission": "0.00000000",
    "commissionAsset": "USDT",
    "time": 1569069506613,
    "buyer": true,
    "maker": false
  }
]

代码示例​

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.prex.world/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.prex.world"

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())