Get Account Transaction History

API Description

Retrieves account transaction history for the authenticated user. This endpoint provides detailed information about account deposit and withdrawal transactions including the amount, asset type, and block information.

HTTP Request

GET /v5/account/account-transaction-history

Request Parameters

Parameter	Type	Required	Description
type	string	No	Transaction type (DEPOSITE, WITHDRAW)
asset	string	No	Asset symbol (e.g., USDM)
startTime	string	No	Start time (ms)
endTime	string	No	End time (ms)
limit	number	No	Number of records (max 100)
cursor	string	No	Cursor for pagination

Response Parameters

Parameter	Type	Description
type	string	Transaction type (DEPOSITE, WITHDRAW)
amount	string	Transaction amount
asset	string	Asset symbol (e.g., USDM)
blockInfo	object	Block information
-> height	number	Block height
-> timestamp	number	Block timestamp

Request Example

cURL

curl -X GET \
  'https://api.synfutures.com/v5/account/transaction-history?limit=20' \
  -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/account/transaction-history?limit=20",
    {
        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/account/transaction-history"
params = {
    'limit': 20
}
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": [
        {
            "type": "DEPOSITE",
            "amount": "100.00",
            "asset": "USDM",
            "blockInfo": {
                "height": 162708,
                "timestamp": 1761278396
            }
        },
        {
            "type": "WITHDRAW",
            "amount": "100.00",
            "asset": "USDM",
            "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"
}