Get Universal Transfer List

Query Universal Transfer List

Only transfers made with the universal transfer API or web transfer will be returned by this endpoint. Transfers made by other endpoints will not be returned.

tip

• Main acct api key or Sub acct api key are both supported
• Main acct api key needs "SubMemberTransfer" permission
• Sub acct api key needs "SubMemberTransferList" permission

info

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

HTTP Request

GET /asset/v3/private/transfer/universal-transfer/list/query

Request Parameters

Parameter	Required	Type	Comments
transferId	true	string	UUID, which is unique across the platform
coin	true	string	Currency type
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, used for pagination

Response Parameters

Parameter	Type	Comments
list	array	Object
> transferId	string	UUID, which is unique across the platform
> coin	string	Currency type
> amount	string	Transfer amount
> timestamp	string	Created timestamp (ms)
> status	string	status
> fromAccountType	string	From account type
> toAccountType	string	To account type
> fromMemberId	string	From UID
> toMemberId	string	To UID
nextPageCursor	string	Cursor, used for pagination.

Request Example

GET /asset/v3/private/transfer/universal-transfer/list/query?coin=USDT&status=SUCCESS HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: xxxxxxxxxxxxx
X-BAPI-API-KEY: xxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1671163509262
X-BAPI-RECV-WINDOW: 5000

Response Example

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "list": [
            {
                "transferId": "42c0cfb0-6bca-c242-bc76-4e6df6cbcb06",
                "coin": "USDT",
                "amount": "10",
                "timestamp": "1671163374000",
                "status": "SUCCESS",
                "fromAccountType": "UNIFIED",
                "toAccountType": "SPOT",
                "fromMemberId": "11111111",
                "toMemberId": "22222222"
            },
            {
                "transferId": "2811a2ca-b42c-4cda-a21f-3df0a1f2516f",
                "coin": "USDT",
                "amount": "5",
                "timestamp": "1670925916000",
                "status": "SUCCESS",
                "fromAccountType": "SPOT",
                "toAccountType": "SPOT",
                "fromMemberId": "111111111",
                "toMemberId": "33333333"
            }
        ],
        "nextPageCursor": "eyJtaW5JRCI6MzU2MTA0LCJtYXhJRCI6MTczNDQ5Mn0="
    },
    "retExtInfo": {},
    "time": 1671163509474
}