Skip to main content

Get Internal Transfer Records

Query the internal transfer records between different account types under the same UID.

info

When both startTime & endTime are not passed, API returns 30 days data by default

HTTP Request

GET /v5/asset/transfer/query-inter-transfer-list

Request Parameters

ParameterRequiredTypeComments
transferIdfalsestringUUID. Use the one you generated in createTransfer
coinfalsestringCoin, uppercase only
statusfalsestringTransfer status
startTimefalseintegerThe start timestamp (ms) Note: the query logic is actually effective based on second level
endTimefalseintegerThe end timestamp (ms) Note: the query logic is actually effective based on second level
limitfalseintegerLimit for data size per page. [1, 50]. Default: 20
cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

Response Parameters

ParameterTypeComments
listarrayObject
> transferIdstringTransfer ID
> coinstringTransferred coin
> amountstringTransferred amount
> fromAccountTypestringFrom account type
> toAccountTypestringTo account type
> timestampstringTransfer created timestamp (ms)
> statusstringTransfer status
nextPageCursorstringRefer to the cursor request parameter

Request Example

GET /v5/asset/transfer/inter-transfer-list-query?coin=USDT&limit=1 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1670988271299
X-BAPI-RECV-WINDOW: 50000

Response Example

{
"retCode": 0,
"retMsg": "success",
"result": {
"list": [
{
"transferId": "selfTransfer_a1091cc7-9364-4b74-8de1-18f02c6f2d5c",
"coin": "USDT",
"amount": "5000",
"fromAccountType": "SPOT",
"toAccountType": "UNIFIED",
"timestamp": "1667283263000",
"status": "SUCCESS"
}
],
"nextPageCursor": "eyJtaW5JRCI6MTM1ODQ2OCwibWF4SUQiOjEzNTg0Njh9"
},
"retExtInfo": {},
"time": 1670988271677
}