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

Parameter	Required	Type	Comments
withdrawID	false	string	Withdraw ID
txID	false	string	Transaction hash ID
coin	false	string	Coin, uppercase only
withdrawType	false	integer	Withdraw type. 0(default): on chain. 1: off chain. 2: all
startTime	false	integer	The start timestamp (ms)
endTime	false	integer	The end timestamp (ms)
limit	false	integer	Limit for data size per page. [1, 50]. Default: 50
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
rows	array	Object
> withdrawId	string	Withdraw ID
> txID	string	Transaction ID. It returns "" when withdrawal failed, withdrawal cancelled
> withdrawType	integer	Withdraw type. 0: on chain. 1: off chain
> coin	string	Coin
> chain	string	Chain
> amount	string	Amount
> withdrawFee	string	Withdraw fee
> status	string	Withdraw status
> toAddress	string	To withdrawal address. Shows the Bybit UID for internal transfers
> tag	string	Tag
> createTime	string	Withdraw created timestamp (ms)
> updateTime	string	Withdraw updated timestamp (ms)
nextPageCursor	string	Cursor. Used for pagination

---

Request Example

HTTP

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: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672194949557
X-BAPI-RECV-WINDOW: 5000

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="xxxxxxxxxxxxxxxxxx",
    api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
)
print(session.get_withdrawal_records(
    coin="USDT",
    withdrawType=2,
    limit=2,
))

Node.js

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

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

client
  .getWithdrawalRecords({
    coin: 'USDT',
    withdrawType: 2,
    limit: 2,
  })
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });

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
}