Search on-chain withdrawal history
- GET
/api/v3/wallet/withdraw/history
Weight(IP): 5
Returns paginated on-chain withdrawal history for the authenticated user. Requires ACCOUNT_DETAILS permission.
Request parameters
| Parameter | Type | Required? | Description |
|---|---|---|---|
| coin | String | No | Asset code. |
| network | String | No | Network name. If specified, coin is also required. |
| clientWithdrawId | String | No | Unique client withdrawal ID. |
| txHash | String | No | On-chain transaction hash. |
| status | Integer | No | Order status. |
| startTime | Long | No | Start creation time in milliseconds, inclusive. If used with endTime, the max. query range is 90 days. |
| endTime | Long | No | End creation time in milliseconds, exclusive. |
| pageNo | Integer | No | Page number, starting from 1. Default: 1. |
| pageSize | Integer | No | Entries per page. Default: 20; maximum: 50. |
Request example
curl "https://api-spot.weex.com/api/v3/wallet/withdraw/history?coin=USDT&pageNo=1&pageSize=20" \
-H "ACCESS-KEY:*******" \
-H "ACCESS-SIGN:*******" \
-H "ACCESS-PASSPHRASE:*****" \
-H "ACCESS-TIMESTAMP:1735632000000"
Response parameters
The common pagination fields are the same as those in the on-chain deposit history endpoint. The items fields are as follows.
| Field name | Type | Description |
|---|---|---|
| clientWithdrawId | String | Unique identifier for client withdrawals. |
| coin | String | Asset code. |
| network | String | Network name. |
| address | String | Withdrawal address. |
| memo | String | Memo/Tag. |
| amount | Decimal | Withdrawal amount. |
| fee | Decimal | Fee. |
| txHash | String | On-chain transaction hash. |
| status | Integer | Order status. |
| createdAt | Long | Creation timestamp in milliseconds. |
| updatedAt | Long | Last updated timestamp in milliseconds. |
Response example
{
"total": 1,
"pageSize": 20,
"pages": 1,
"page": 1,
"hasNextPage": false,
"items": [
{
"clientWithdrawId": "vhak1ckuwNzqVr0AGj1uDYUpava2sdcvad",
"coin": "USDT",
"network": "BSC",
"address": "0x4a5EF3a85370d5b86sBE194ADa2281f4F1e755a1",
"memo": "",
"amount": 0.001,
"fee": -0.00001,
"txHash": null,
"status": 0,
"createdAt": 1787819548774,
"updatedAt": 1787819548774
}
]
}