Skip to main content

Get Transfer Record

Frequency limit: 20 times/1s (User ID)

Description

Get transfer record

HTTP Request

  • GET /api/v2/spot/account/transferRecords
Request Example
curl "https://api.bitget.com/api/v2/spot/account/transferRecords?coin=USDT&fromType=exchange&startTime=1659076670&endTime=1659076670&limit=100" \
-H "ACCESS-KEY:*******" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json"

Request Parameters

ParameterTypeRequiredDescription
coinStringYesToken name
fromTypeStringYesAccount type
spot: Spot account
p2p: P2P/funding account
coin_futures: Coin-M futures account
usdt_futures: USDT-M futures account
usdc_futures: USDC-M futures account
crossed_margin: Cross margin account
isolated_margin: Isolated margin account
startTimeStringNoThe start time of the billing history, i.e., getting the billing history after that timestamp
Unix millisecond timestamp, e.g. 1690196141868
endTimeStringNoThe end time of the billing history, i.e., getting the billing history before that timestamp
Unix millisecond timestamp, e.g. 1690196141868
The interval between startTime and endTime must not exceed 90 days.
clientOidStringNoOrder ID customized by user
limitStringNoNumber of results returned: Default: 100, maximum 500
idLessThanStringNoRequests the content on the page before this ID (older data), the value input should be the transferId of the corresponding interface.
Response Example
{
"code": "00000",
"data": [
{
"coin": "btc",
"status": "Successful",
"toType": "usdt_futures",
"toSymbol": "",
"fromType": "spot",
"fromSymbol": "BTC/USD",
"size": "1000.00000000",
"ts": "1631070374488",
"clientOid": "1",
"transferId": "1"
}
],
"msg": "success",
"requestTime": 1631608142260
}

Response Parameters

ParameterTypeDescription
coinStringToken name
statusStringStatus of transfer
Successful: Successful
Failed: Failed
Processing: Processing
toTypeStringRecipient account type
spot: Spot account
p2p: P2P/funding account
coin_futures: Coin-M futures account
usdt_futures: USDT-M futures account
usdc_futures: USDC-M futures account
crossed_margin: Cross margin account
isolated_margin: Isolated margin account
toSymbolStringTrading pair for the recipient account
Returned when the recipient account is isolated_margin
fromTypeStringSender account type
spot: Spot account
p2p: P2P/funding account
coin_futures: Coin-M futures account
usdt_futures: USDT-M futures account
usdc_futures: USDC-M futures account
crossed_margin: Cross margin account
isolated_margin: Isolated margin account
fromSymbolStringTrading pair for the sending account
Return when the sending account is isolated_margin
sizeStringQuantity
tsStringTransfer time, Unix millisecond timestamp, e.g. 1690196141868
clientOidStringOrder ID customized by user
transferIdStringTransfer order ID

How was your Reading Experience with us?