Wallet
Error Codes
These public OpenAPI error codes apply to wallet and self-transfer endpoints. Messages are in English; %s and %d are replaced with actual values in responses.
Code
| Code | HTTP status | Message |
|---|---|---|
| -2400 | 400 | Wallet request parameter is invalid. |
| -2401 | 429 | Too many wallet requests, please retry later. |
| -2402 | 503 | Wallet service is temporarily unavailable, please retry later. |
| -2403 | 400 | User does not exist. |
| -2404 | 403 | Withdrawal is locked for 24 hours because the fund password was entered incorrectly 5 times. |
| -2405 | 403 | Withdrawal is locked for 24 hours after the security settings were changed. |
| -2406 | 403 | This operation is restricted. |
| -2407 | 503 | User service error, please retry later. |
| -2408 | 403 | This user is not allowed to perform the operation. |
| -2409 | 503 | Wallet service error, please retry later. |
| -2410 | 400 | Illegal wallet parameter. |
| -2411 | 400 | Wallet parameter validation failed. |
| -2412 | 400 | Coin is not supported. |
| -2413 | 400 | Insufficient balance. |
| -2414 | 400 | Withdrawal amount is below the minimum. |
| -2415 | 400 | Withdrawal amount cannot cover the fee. |
| -2416 | 400 | Withdrawal limit exceeded. |
| -2417 | 400 | Withdrawal is disabled for this coin or network. |
| -2418 | 400 | The address does not belong to the user. |
| -2419 | 400 | The order is under review. |
| -2420 | 400 | The withdrawal address is illegal. |
| -2421 | 403 | KYC verification is required for the current IP. |
| -2422 | 500 | Wallet service returned an unknown error. |
| -2423 | 503 | Wallet service is unavailable, please retry later. |
| -2424 | 500 | Wallet service returned an empty response. |
| -2425 | 403 | API access is restricted. |
| -2426 | 403 | User account is frozen. |
| -2427 | 403 | Wallet operation failed after KYC verification. |
| -2428 | 403 | KYC verification is required for this account. |
| -2430 | 503 | Coin configuration is unavailable, please retry later. |
| -2431 | 400 | Coin '%s' is not supported. |
| -2432 | 400 | Network '%s' is not supported for coin '%s'. |
| -2433 | 400 | Deposit is disabled for coin '%s' on network '%s'. |
| -2434 | 400 | Withdrawal is disabled for coin '%s' on network '%s'. |
| -2435 | 400 | addressTag is required for coin '%s' on network '%s'. |
| -2436 | 400 | The withdrawal address is invalid for the selected coin and network. |
| -2437 | 400 | Withdrawal amount must be at least %s. |
| -2438 | 400 | accountList contains an unsupported account type: %s. |
| -2439 | 400 | clientWithdrawId must contain 16 to 32 ASCII letters or digits, optionally prefixed with 'openapi_'. |
| -2440 | 400 | The receiving UID does not exist. |
| -2441 | 400 | Internal transfer to yourself is not allowed. |
| -2442 | 500 | Asset transfer failed. |
| -2443 | 503 | Asset transfer is processing. Retry with the same bizId. |
| -2444 | 400 | fromAccountType and toAccountType cannot be the same. |
| -2445 | 409 | bizId already exists. Reuse it only with the original request parameters. |
| -2446 | 400 | Legacy spot account is not supported. Use SPOT instead. |
| -2447 | 400 | bizId must contain 16 to 32 ASCII letters or digits, optionally prefixed with 'openapi_'. |
| -2448 | 400 | The withdrawal address has not been added to Withdrawal Address Management. |
| -2449 | 403 | The withdrawal address is frozen. Wait 24 hours after adding it to Withdrawal Address Management before withdrawing. |
| -2450 | 429 | Only one withdrawal per address, coin and network combination is allowed every 10 seconds. A withdrawal may also be processing; please retry later. |
| -2451 | 400 | The Travel Rule form information is invalid. Please check the submitted fields. |
| -2452 | 400 | Exceeds the maximum amount available for transfer. |
Authentication and parameter errors
-1192:Withdrawals are frozen for this API key. Freeze end time: %d (Unix milliseconds).- The freeze end time is a Unix timestamp in milliseconds. Calls requiring withdrawal permission are blocked while the API key is frozen.
-1160:Decimal precision error.The transfer amount exceeds the configured coin precision.
See Error Codes for other common errors.