API error responses

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 messageExplanationSolution
"Consolidation Skipped for 0xFF301F0174c317BACA4eE98E00e95Ddb92AfB2A0 due to min amount rule violation: {"currentBalance":"0.274786727528","minRequired":"20","currency":"USD"}"The address is skipped because the balance falls below the minimum USD threshold set 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 because the balance falls below the minimum threshold in the native currency, set 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"": 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 y
},
""message"": null
}

wallet.walletId

invalid

404

{
""success"": false,
""data"": {},
""message"": ""Wallet not found"",
""code"": """"
}

wallet.walletId

Null or empty

500

{
""success"": false,
""data"": {
""errors"": by the Consolidate wallet assets API.

Skipped address errors

When you call the API, most of the addresses are conso
},
""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