Get CFD Transfer Records

Description

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

HTTP Request

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

Request

curl "https://api.bitget.com/api/v3/cfd/account/transfer-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
transferId	String	No	Transfer ID
subUid	String	No	Sub-account UID Used by a master account to query a sub-account's transfer records
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
direction	String	No	Transfer direction in: Deposit into the CFD account out: Withdraw from the CFD account If not provided, records for all directions are returned
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": {
    "list": [
      {
        "transferId": "111111111111111111",
        "coin": "USDT",
        "amount": "100",
        "direction": "in",
        "status": "success",
        "accountType": "uta",
        "createdTime": "1740000000000",
        "updatedTime": "1740000000000"
      }
    ],
    "cursor": "111111111111111112"
  }
}

Response Parameters

Parameters	Type	Description
list	List\<Object>	List
> transferId	String	Transfer ID
> coin	String	Coin transferred
> amount	String	Amount transferred
> direction	String	Transfer direction in: Deposit into the CFD account out: Withdraw from the CFD account
> status	String	Status ongoing: In progress failed: Failed success: Successful
> accountType	String	Account type funding: Spot/Funding account uta: Unified Trading Account
> createdTime	String	Creation time A Unix millisecond timestamp
> updatedTime	String	Update time A Unix millisecond timestamp
cursor	String	Cursor ID