查詢萬能劃轉記錄

查詢萬能劃轉記錄

該接口僅返回通過萬能劃轉接口以及網頁端的母子和子子劃轉的紀錄，通過其他劃轉接口的轉帳的紀錄將不會返回。

提示

• 母子帳號的api key都支持調用
• 母帳號的api key需擁有"母子帳戶劃轉"(SubMemberTransfer)權限
• 子帳號的api key需擁有"母子帳戶劃轉"(SubMemberTransferList)權限

信息

當startTime & endTime都不傳入時, API默認返回30天的數據

HTTP 請求

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

請求參數

參數	是否必須	類型	說明
transferId	true	string	UUID,全局唯一
coin	true	string	幣種類型
status	false	string	劃轉狀態
startTime	false	integer	開始時間戳（毫秒) 注意: 實際查詢時是秒級維度生效
endTime	false	integer	結束時間戳（毫秒) 注意: 實際查詢時是秒級維度生效
limit	false	integer	每頁數量限制. [1, 50]. 默認: 20
cursor	false	string	游標, 用來分頁

返回參數

參數	類型	說明
list	array	Object
> transferId	string	UUID,全局唯一
> coin	string	幣種類型
> amount	string	劃轉數量
> timestamp	string	創建時間戳 (毫秒)
> status	string	劃轉狀態
> fromAccountType	string	劃出賬戶類型
> toAccountType	string	劃入賬戶類型
> fromMemberId	string	劃出的UID
> toMemberId	string	劃入UID
nextPageCursor	string	游標信息：用來分頁

請求示例

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

響應示例

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