User Trade History

Description

Get trade history for a specific trading pair.

HTTP Request

GET /fapi/v1/userTrades (HMAC SHA256)

Weight

5

Request Parameters

Name	Type	Required	Description
symbol	STRING	YES	Trading pair
orderId	LONG	NO	System order ID
startTime	LONG	NO	Start time
endTime	LONG	NO	End time
fromId	LONG	NO	Starting trade ID
limit	INT	NO	Default 500; Max 1000
timestamp	LONG	YES	Timestamp

Response Example

[
  {
    "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
  }
]

Returns data for the most recent 3 months only.

Code Examples

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