Get CFD Financial Records

Description

This endpoint is used to query the financial records of a CFD account.

HTTP Request

• GET /api/v3/cfd/account/financial-records
• Rate limit: 1/sec/UID
• Permission: UTA account (read-only)

Request

curl "https://api.bitget.com/api/v3/cfd/account/financial-records?limit=10" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

Request Parameters

Parameters	Type	Required	Description	Comments
type	String	No	Financial record type
startTime	String	No	Start time A Unix millisecond timestamp	The query span per request must not exceed 30 days The maximum lookback period is 90 days
endTime	String	No	End time A Unix millisecond timestamp	The query span per request must not exceed 30 days The maximum lookback period is 90 days
limit	String	No	Number of entries per page Default: 10, range [1, 50]
cursor	String	No	Cursor ID

Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740000000000,
  "data": [
    {
      "id": 1,
      "symbol": "XAUUSD",
      "side": 1,
      "qty": 1,
      "swap": 0,
      "fee": 0.5,
      "cashFlow": 10.5,
      "balanceBefore": 9989.5,
      "balanceChange": 10,
      "balanceAfter": 9999.5,
      "creditBefore": 0,
      "creditChange": 0,
      "creditAfter": 0,
      "openPrice": 2610.00,
      "closePrice": 2620.00,
      "orderId": 111111111111111112,
      "ts": 1740000000000
    }
  ]
}

Response Parameters

Parameters	Type	Description
id	Integer	Record ID
symbol	String	Trading pair name
side	Integer	Trade side buy: Buy sell: Sell
qty	Number	Trade quantity
swap	Number	Swap fee
fee	Number	Commission fee
cashFlow	Number	Cash flow (Settled PnL, deposits/withdrawals, compensation amounts, etc.); excludes commission fee and swap fee
balanceBefore	Number	Balance before the change
balanceChange	Number	Balance change cashFlow + swap + fee
balanceAfter	Number	Balance after the change
creditBefore	Number	Credit before the change
creditChange	Number	Credit change
creditAfter	Number	Credit after the change
openPrice	Number	Opening price
closePrice	Number	Closing price
orderId	Integer	Order ID
ts	Integer	Record time