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

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. SUCCESS,FAILED,PENDING
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
> fromMemberId	string	From UID
> toMemberId	string	TO UID
> 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/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

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
print(session.get_universal_transfer_records(
    limit=1,
    cursor="eyJtaW5JRCI6MTc5NjU3OCwibWF4SUQiOjE3OTY1Nzh9",
))

Node.js

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

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

client
  .getUniversalTransferRecords({
    limit: 1,
    cursor: 'eyJtaW5JRCI6MTc5NjU3OCwibWF4SUQiOjE3OTY1Nzh9',
  })
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });

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
}