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

Upcoming changes

• If startTime and endTime are not provided, the API returns data from the past 7 days by default.
• If only startTime is provided, the API returns records from startTime to startTime + 7 days.
• If only endTime is provided, the API returns records from endTime - 7 days to endTime.
• If both are provided, the maximum allowed range is 7 days (endTime - startTime ≤ 7 days).

Deployment timeline:

1. Accounts with UID ending in "0": April 15
2. All other accounts: April 16

HTTP Request

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

Request Parameters

Parameter	Required	Type	Comments
transferId	false	string	UUID. Use the one you generated in createTransfer
coin	false	string	Coin, uppercase only
status	false	string	Transfer status
startTime	false	integer	The start timestamp (ms) Note: the query logic is actually effective based on second level
endTime	false	integer	The end timestamp (ms) Note: the query logic is actually effective based on second level
limit	false	integer	Limit for data size per page. [1, 50]. Default: 20
cursor	false	string	Cursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

Response Parameters

Parameter	Type	Comments
list	array	Object
> transferId	string	Transfer ID
> coin	string	Transferred coin
> amount	string	Transferred amount
> fromAccountType	string	From account type
> toAccountType	string	To account type
> timestamp	string	Transfer created timestamp (ms)
> status	string	Transfer status
nextPageCursor	string	Refer to the cursor request parameter

---

Request Example

HTTP

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

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
print(session.get_internal_transfer_records(
    coin="USDT",
    limit=1,
))

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
  testnet: true,
  key: 'apikey',
  secret: 'apisecret',
});

client
  .getInternalTransferRecords({
    coin: 'USDT',
    limit: 1,
  })
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });

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
}