Get Transactions

List balance-affecting transactions on your futures account: trading fees, funding payments, P&L, add-margin, liquidation fees.

HTTP

Method	GET
Endpoint	/trade/api/v2/futures/transactions
Rate limit	20 requests per 60 seconds

Request Parameters

Parameter	Type	Mandatory	Description
exchange	string	Yes	EXCHANGE_2.
symbol	string	No	Filter to a single symbol (e.g. btcusdt).
type	string	No	Filter by type: commission, P&L, funding fee, liquidation fee.
limit	integer	No	Maximum number of records to return.
from_time	integer	No	Start of the time range (Unix ms).
to_time	integer	No	End of the time range (Unix ms).

Example

Python

import requests

headers, path = sign_request("GET", "/trade/api/v2/futures/transactions", params={
    "exchange": "EXCHANGE_2",
    "symbol": "btcusdt",
    "type": "commission",
    "limit": 20,
})
response = requests.get(BASE_URL + path, headers=headers)
print(response.json())

Java

Map<String, String> p = Map.of(
    "exchange", "EXCHANGE_2",
    "symbol", "btcusdt",
    "type", "commission",
    "limit", "20"
);
HttpResponse<String> resp = client.send(
    "GET", "/trade/api/v2/futures/transactions", p, null);
System.out.println(resp.body());

Go

headers, p, err := SignRequest("GET", "/trade/api/v2/futures/transactions", map[string]string{
    "exchange": "EXCHANGE_2",
    "symbol":   "btcusdt",
    "type":     "commission",
    "limit":    "20",
})
if err != nil { panic(err) }

req, _ := http.NewRequest("GET", BaseURL+p, nil)
for k, v := range headers { req.Header.Set(k, v) }
resp, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
out, _ := io.ReadAll(resp.Body)
fmt.Println(string(out))

Node.js

const {signRequest, BASE_URL} = require('./reference-client');

const {headers, path} = signRequest('GET', '/trade/api/v2/futures/transactions', {
  exchange: 'EXCHANGE_2',
  symbol:   'btcusdt',
  type:     'commission',
  limit:    20,
});
const r = await fetch(BASE_URL + path, { method: 'GET', headers });
console.log(await r.json());

Response

{
  "data": [
    {
      "exchange": "EXCHANGE_2",
      "transaction_id": "678708aa-507b-4881-8b3f-1a50b63dd0c4-0193677c-0544-77d1-b3a6-2130d671e54c",
      "symbol": "ADAUSDT",
      "type": "FUNDING_FEE",
      "quote_asset": "USDT",
      "amount": "0.00099946"
    },
    {
      "exchange": "EXCHANGE_2",
      "transaction_id": "8b81b763-df36-4c93-9bc8-9a93d65b8546",
      "symbol": "DOGEUSDT",
      "type": "ADD_MARGIN",
      "quote_asset": "USDT",
      "amount": "16"
    }
  ]
}

Response Parameters

data is an array of transactions:

Field	Type	Description
exchange	string	Exchange identifier.
transaction_id	string	Unique transaction ID.
symbol	string	Symbol the transaction relates to.
type	string	One of FUNDING_FEE, COMMISSION, P&L, LIQUIDATION_FEE, ADD_MARGIN.
quote_asset	string	Asset of the amount field, currently always USDT.
amount	string	Signed amount. Positive for credits, negative for debits.