Get Trade History

API Description

Retrieves historical trade execution data for the authenticated user. This endpoint provides detailed information about all executed trades including fill prices, quantities, and fees.

HTTP Request

GET /v5/execution/list

Request Parameters

Parameter	Type	Required	Description
symbol	string	No	Symbol name (e.g., BTCUSDT)
startTime	string	No	Start time (ms)
endTime	string	No	End time (ms)
limit	number	No	Number of records (max 1000)
cursor	string	No	Cursor for pagination

Response Parameters

Parameter	Type	Description
orderId	number	Order ID
type	string	Trade type (LIMIT, MARKET, etc.)
price	string	Execution price
side	string	Order side (LONG, SHORT)
size	string	Order size
markPrice	string	Mark price at execution time
tradeFee	string	Trade fee amount
feeRate	string	Fee rate applied
tradeValue	string	Trade value (size × price)
balance	string	Account balance after trade
leverage	string	Leverage used
time	string	Trade timestamp
blockInfo	object	Block information
-> height	number	Block height
-> timestamp	number	Block timestamp

Request Example

cURL

curl -X GET \
  'https://api.synfutures.com/v5/execution/list?category=linear&symbol=BTCUSDT&limit=50' \
  -H 'Content-Type: application/json' \
  -H 'X-BAPI-API-KEY: [api_key]' \
  -H 'X-BAPI-SIGN: [signature]' \
  -H 'X-BAPI-TIMESTAMP: [timestamp]' \
  -H 'X-BAPI-RECV-WINDOW: 5000'

JavaScript (Fetch)

const response = await fetch(
    "https://api.synfutures.com/v5/execution/list?category=linear&symbol=BTCUSDT&limit=50",
    {
        method: "GET",
        headers: {
            "Content-Type": "application/json",
            "X-BAPI-API-KEY": "[api_key]",
            "X-BAPI-SIGN": "[signature]",
            "X-BAPI-TIMESTAMP": "[timestamp]",
            "X-BAPI-RECV-WINDOW": "5000",
        },
    }
);

const data = await response.json();
console.log(data);

Python (requests)

import requests

url = "https://api.synfutures.com/v5/execution/list"
params = {
    'category': 'linear',
    'symbol': 'BTCUSDT',
    'limit': 50
}
headers = {
    'Content-Type': 'application/json',
    'X-BAPI-API-KEY': '[api_key]',
    'X-BAPI-SIGN': '[signature]',
    'X-BAPI-TIMESTAMP': '[timestamp]',
    'X-BAPI-RECV-WINDOW': '5000'
}

response = requests.get(url, headers=headers, params=params)
result = response.json()
print(result)

Response Example

Success Response

{
    "data": [
        {
            "instrumentAddrress": "0x1a8a5872b5b82686e1271a363556335a5f540dae",
            "symbol": "BTC-USDM-EMG",
            "expiry": 4294967295,
            "orderId": 1407155437568,
            "orderType": "LIMIT",
            "price": "4389105219931565477678",
            "side": "SHORT",
            "size": "-100000000000000000",
            "markPrice": "4389105219931565477678",
            "tradeFee": "100.00",
            "feeRate": "0.0001",
            "tradeValue": "100.00",
            "balance": "87782105000000000000",
            "leverage": "10",
            "time": "1684738540559",
            "blockInfo": {
                "height": 162708,
                "timestamp": 1761278396
            }
        }
    ],
    "msg": "",
    "code": 200,
    "requestId": "bbf4fa1a-0f41-449f-8d9c-44fdceae0bf7"
}

Error Response

{
    "code": 400,
    "msg": "Request parameter error",
    "data": {},
    "requestId": "bbf4fa1a-0f41-449f-8d9c-44fdceae0bf7"
}