Get Withdraw Records

Query Withdraw Records

Rules

Rules: order by id in reverse order. The maximum difference between the start time and the end time is 30 days.

HTTP Request

GET /asset/v3/private/withdraw/record/query

Request Parameters

Parameter	Required	Type	Comments
withdrawID	false	integer	withdrawal id. (withdraw request ID in Response Parameters of Withdrawal endpoint)
txID	false	string	Transaction hash ID
startTime	false	integer	The start time (ms). Default value: 30 days before the current time
endTime	false	integer	The end time (ms). Default value: current time
coin	false	string	coin name: for example, BTC. Default value: all
withdrawType	false	string	0 (default)：on chain. 1：off chain. 2：on and off chain
cursor	false	string	Cursor, used for pagination
limit	false	integer	Number of items per page. [1, 50] Default value: 50

Response Parameters

Parameter	Type	Comments
rows	array	Object
> coin	string	withdrawal coin
> chain	string	chain name
> amount	string	withdrawal quantity
> txID	string	transaction ID. It returns "" when withdrawal failed, withdrawal cancelled
> status	string	status
> toAddress	string	withdrawal target address. It shows email or mobile number for internal transfer
> tag	string	tag of withdrawal target address
> withdrawFee	string	withdrawal fee
> createTime	string	withdrawal create time
> updateTime	string	withdrawal status updated time
> withdrawId	string	withdrawal id. (withdraw request ID in Response Parameters of Withdrawal endpoint)
> withdrawType	integer	Withdraw type. 0：on chain; 1：internal address transfer
nextPageCursor	string	cursor information, used for pagination

Request Example

GET /asset/v3/private/withdraw/record/query HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: xxxxxxxxxxx
X-BAPI-API-KEY: xxxxxxxxxxx
X-BAPI-TIMESTAMP: 1671171632559
X-BAPI-RECV-WINDOW: 50000

Response Example

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "rows": [
            {
                "coin": "USDT",
                "chain": "TRX",
                "amount": "10",
                "txID": "",
                "status": "CancelByUser",
                "toAddress": "xxxxxxxxxxx",
                "tag": "",
                "withdrawFee": "1",
                "createTime": "1670906044000",
                "updateTime": "1670906050000",
                "withdrawId": "9965",
                "withdrawType": 0
            },
            {
                "coin": "USDT",
                "chain": "TRX",
                "amount": "10",
                "txID": "",
                "status": "CancelByUser",
                "toAddress": "xxxxxxxxxxx",
                "tag": "",
                "withdrawFee": "1",
                "createTime": "1670905993000",
                "updateTime": "1670906001000",
                "withdrawId": "9964",
                "withdrawType": 0
            }
        ],
        "nextPageCursor": "eyJtaW5JRCI6OTk2NCwibWF4SUQiOjk5NjV9"
    },
    "retExtInfo": {},
    "time": 1671171632649
}