Skip to main content

Get Withdrawal Records

Query withdrawal records.

tip
  • endTime - startTime should be less than 30 days. Query last 30 days records by default.
  • Can query by the master UID's api key only

HTTP Request

GET /v5/asset/withdraw/query-record

Request Parameters

ParameterRequiredTypeComments
withdrawIDfalsestringWithdraw ID
txIDfalsestringTransaction hash ID
coinfalsestringCoin, uppercase only
withdrawTypefalseintegerWithdraw type. 0(default): on chain. 1: off chain. 2: all
startTimefalseintegerThe start timestamp (ms)
endTimefalseintegerThe end timestamp (ms)
limitfalseintegerLimit for data size per page. [1, 50]. Default: 50
cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

Response Parameters

ParameterTypeComments
rowsarrayObject
> withdrawIdstringWithdraw ID
> txIDstringTransaction ID. It returns "" when withdrawal failed, withdrawal cancelled
> withdrawTypeintegerWithdraw type. 0: on chain. 1: off chain
> coinstringCoin
> chainstringChain
> amountstringAmount
> withdrawFeestringWithdraw fee
> statusstringWithdraw status
> toAddressstringTo withdrawal address. Shows the Bybit UID for internal transfers
> tagstringTag
> createTimestringWithdraw created timestamp (ms)
> updateTimestringWithdraw updated timestamp (ms)
nextPageCursorstringCursor. Used for pagination

Request Example

GET /v5/asset/withdraw/query-record?coin=USDT&withdrawType=2&limit=2 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672194949557
X-BAPI-RECV-WINDOW: 5000

Response Example

{
"retCode": 0,
"retMsg": "success",
"result": {
"rows": [
{
"coin": "USDT",
"chain": "ETH",
"amount": "77",
"txID": "",
"status": "SecurityCheck",
"toAddress": "0x99ced129603abc771c0dabe935c326ff6c86645d",
"tag": "",
"withdrawFee": "10",
"createTime": "1670922217000",
"updateTime": "1670922217000",
"withdrawId": "9976",
"withdrawType": 0
},
{
"coin": "USDT",
"chain": "internalAddressChain",
"amount": "20.1234",
"txID": "",
"status": "success",
"toAddress": "999805",
"tag": "",
"withdrawFee": "0",
"createTime": "1698889833000",
"updateTime": "1698889846000",
"withdrawId": "13310",
"withdrawType": 1
}
],
"nextPageCursor": "eyJtaW5JRCI6OTgwMSwibWF4SUQiOjk5NzZ9"
},
"retExtInfo": {},
"time": 1672194949928
}