The following tables describe the types of error responses returned by the Consolidate wallet assets API.
Skipped address errors
When you call the API, most of the addresses are consolidated excluding one or more addresses that are skipped due to various reasons like low balance, exceeded fee limits, etc. The following table lists few of such errors for the skipped addresses that you receive in the success response.
| Error message | Explanation | Solution |
|---|---|---|
| "Consolidation Skipped for 0xFF301F0174c317BACA4eE98E00e95Ddb92AfB2A0 due to min amount rule violation: {"currentBalance":"0.274786727528","minRequired":"20","currency":"USD"}" | The address is skipped due to its current balance of the address being below the minimum balance threshold in USD set up in Smart Consolidation. | Update your Smart Consolidation Rule by editing the Minimum Amount (per address) field. See Set up Smart Consolidation Rule for more information. |
| "Consolidation Skipped for 0xf481D1fF229d8357413aF14727d6D4d22f7eE95B due to min amount rule violation: {"currentBalance":"0.00394309","minRequired":"0.01","currency":"NATIVE"}" | The address is skipped due to its current balance of the address being below the minimum balance threshold in the native currency, set up in Smart Consolidation. | Update your Smart Consolidation Rule by editing the Minimum Amount (per address) field. See Set up Smart Consolidation Rule for more information. |
| "Final amount 14.10952 is less than min consolidation amount 15" | The address is skipped because its final amount (after deducting gas fee) is below the minimum balance threshold set up in Smart Consolidation. | Ensure that either you have sufficient native coin balance in your Gas Station or in the address to cover the gas fees. |
Note
- The error messages, one for each chain, may have the same meaning but differ in wording.
Payload validation errors
| Error Type | HTTP Status code | Example Response | Property |
|---|---|---|---|
| address not whitelisted | 500 | { ""success"": false, ""data"": {}, ""message"": ""address is not whitelisted"", ""code"": """" } | transactions.consolidateOptions.targetAddress |
| Null or empty | 400 | { ""success"": false, ""data"": { ""errors"": [ { ""msg"": ""wallet id is required"", ""param"": ""wallet.walletId"", ""location"": ""body"" }, { ""msg"": ""wallet id should be positive number"", ""param"": ""wallet.walletId"", ""location"": ""body"" } ] }, ""message"": null } | wallet.walletId |
| invalid | 404 | { ""success"": false, ""data"": {}, ""message"": ""Wallet not found"", ""code"": """" } | wallet.walletId |
| Null or empty | 500 | { ""success"": false, ""data"": { ""errors"": [ { ""msg"": ""coin is required"", ""param"": ""wallet.coin"", ""location"": ""body"" } ] }, ""message"": null } | wallet.coin |
| invalid | 500 | { ""success"": false, ""data"": {}, ""message"": ""Invalid Coin"", ""code"": """" } | wallet.coin |
| Null or empty | 500 | { ""success"": false, ""data"": {}, ""message"": ""Target address is required for consolidation"", ""code"": """" } | transactions.consolidateOptions.targetAddress |
| unsupported chains | 500 | { ""success"": false, ""data"": {}, ""message"": ""{""chain"":""Supported to UTXO,EVM,DOT,SOL,CARDANO, NEAR, ALGORAND and TRON chains Only.""}"", ""code"": """" } | unsupported chains (xrp etc) |
Payload authorization errors
| Error Type | HTTP Status Code | Example Response | Property |
|---|---|---|---|
| Null / empty / Invalid | 401 | { ""success"": false, ""data"": {}, ""message"": ""UnAuthorized Access"", ""code"": """" } | Invalid auth Credentials |
| Null / empty / Invalid | 401 | { ""success"": false, ""data"": {}, ""message"": ""UnAuthorized Access"", ""code"": """" } | client_id |
| Null / empty / Invalid | 401 | { ""success"": false, ""data"": {}, ""message"": ""UnAuthorized Access"", ""code"": """" } | client_secret |