Get Withdrawal Records
Get your withdrawal history with optional filters.
HTTP Request
GET /api/v1/spot/account/withdrawal-records
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| startTime | string | Yes | Start time in milliseconds (Unix timestamp) |
| endTime | string | Yes | End time in milliseconds (Unix timestamp) |
| coin | string | No | Coin symbol filter |
| orderId | string | No | Specific order ID to query |
| idLessThan | string | No | Get records with ID less than this value |
| limit | string | No | Number of records to return |
Request Example
curl -X GET "https://open-api.bydoxe.com/api/v1/spot/account/withdrawal-records?startTime=1700000000000&endTime=1732000000000&coin=USDT&limit=50" \
-H "ACCESS-KEY: your-api-key" \
-H "ACCESS-SIGN: your-signature" \
-H "ACCESS-PASSPHRASE: your-passphrase" \
-H "ACCESS-TIMESTAMP: 1659076670000"
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | string | Response code |
| msg | string | Response message |
| requestTime | number | Request timestamp in milliseconds |
| data | array | Array of withdrawal records |
| > orderId | string | Withdrawal order ID |
| > tradeId | string | Trade ID |
| > coin | string | Coin symbol |
| > type | string | Transaction type: "withdraw" |
| > dest | string | Destination: "on_chain" |
| > size | string | Withdrawal amount |
| > fee | string | Withdrawal fee |
| > status | string | Status: "pending", "completed", "failed" |
| > fromAddress | string | From address |
| > toAddress | string | Destination address |
| > chain | string | Blockchain network |
| > tag | string | Destination tag/memo |
| > cTime | string | Creation time in milliseconds |
| > uTime | string | Last update time in milliseconds |
Response Example
Success Response
{
"code": "00000",
"msg": "success",
"requestTime": 1732000000000,
"data": [
{
"orderId": "123456789",
"tradeId": "987654321",
"coin": "USDT",
"type": "withdraw",
"dest": "on_chain",
"size": "100.00",
"fee": "1.00",
"status": "completed",
"fromAddress": "0xabc...",
"toAddress": "0x1234...",
"chain": "ETH",
"tag": "",
"cTime": "1763459280833",
"uTime": "1763459280900"
}
]
}
Error Codes
| Code | Message |
|---|---|
| 40001 | Invalid time format |
| 40002 | Unauthorized |
| 43003 | Coin not found |
| 50000 | System error |