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
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
}