用户成交滑点

接口描述

查询已认证用户每笔成交的滑点。每条记录将下单时刻的预期价格（mark_price_at_creation）与实际成交价做对比。

滑点带符号，正值表示对用户不利（BUY 多付、SELL 少收）。Maker 成交通常滑点 ≈ 0（限价保证）。

HTTP 请求

GET /fapi/v1/userTrades/slippage (HMAC SHA256)

请求权重

5

请求参数

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

响应字段

字段	类型	描述
symbol	STRING	交易对
tradeId	STRING	成交 ID
orderId	STRING	用户本侧订单 ID
side	STRING	BUY / SELL（用户视角）
orderType	STRING	LIMIT / MARKET
expectedPrice	STRING	下单时捕获的 mark price
executedPrice	STRING	实际成交价
qty	STRING	成交数量（基础币）
slippageAbs	STRING	带符号的绝对滑点（以计价币）
slippageBps	STRING	带符号的滑点（基点，正值对用户不利）
maker	BOOL	用户是否为 maker
time	LONG	成交时间戳（毫秒）

计算公式

sign = BUY 取 +1，SELL 取 -1
slippageAbs = (executedPrice - expectedPrice) * sign
slippageBps = slippageAbs / expectedPrice * 10000

响应示例

[
  {
    "symbol": "BTCUSDT",
    "tradeId": "0fbb7679-7960-41b1-8025-054450129024",
    "orderId": "b8bab68c-d41b-462b-8a9e-d451ac1e1665",
    "side": "BUY",
    "orderType": "LIMIT",
    "expectedPrice": "71101.000000000000000000",
    "executedPrice": "70808.990000000000000000",
    "qty": "0.008431111111110778",
    "slippageAbs": "-292.010000000000000000",
    "slippageBps": "-41.0697",
    "maker": true,
    "time": 1776066625866
  }
]

上例为 BUY 成交，实际成交价比预期低 292 USDT，负滑点意味着对用户有利。

代码示例

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.ztdx.io/fapi/v1/userTrades/slippage?${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/userTrades/slippage", params={"symbol": "BTCUSDT", "limit": "500"})
print(resp.json())