Skip to main content

Get Universal Transfer Records

Query universal transfer records

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 /v5/asset/transfer/query-universal-transfer-list

Request Parameters

ParameterRequiredTypeComments
transferIdfalsestringUUID. Use the one you generated in createTransfer
coinfalsestringCoin, uppercase only
statusfalsestringTransfer status. SUCCESS,FAILED,PENDING
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
> fromMemberIdstringFrom UID
> toMemberIdstringTO UID
> fromAccountTypestringFrom account type
> toAccountTypestringTo account type
> timestampstringTransfer created timestamp (ms)
> statusstringTransfer status
nextPageCursorstringRefer to the cursor request parameter

Request Example

GET /v5/asset/transfer/query-universal-transfer-list?limit=1&cursor=eyJtaW5JRCI6MTc5NjU3OCwibWF4SUQiOjE3OTY1Nzh9 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN-TYPE: 2
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672190762800
X-BAPI-RECV-WINDOW: 5000

Response Example

{
"retCode": 0,
"retMsg": "success",
"result": {
"list": [
{
"transferId": "universalTransfer_4c3cfe2f-85cb-11ed-ac09-9e37823c81cd_533285",
"coin": "USDC",
"amount": "1000",
"timestamp": "1672134373000",
"status": "SUCCESS",
"fromAccountType": "UNIFIED",
"toAccountType": "UNIFIED",
"fromMemberId": "533285",
"toMemberId": "592324"
}
],
"nextPageCursor": "eyJtaW5JRCI6MTc4OTYwNSwibWF4SUQiOjE3ODk2MDV9"
},
"retExtInfo": {},
"time": 1672190763079
}