You can transfer cryptocurrency assets from your customer addresses within your deposit wallet and consolidate them into a destination wallet. You can call the API once and consolidate funds from a single or multiple addresses. To learn more about consolidation, see Digital asset consolidation. To learn about different use cases of this API, see Consolidate wallet assets API.
To retrieve a list of addresses eligible for consolidation for a particular chain, use the Retrieve a list of addresses for consolidation API.
The API has a rate limit of 15 seconds per request. For the transaction to be fully signed and broadcast, ensure that the transaction execution job is running on your Liminal Express server.
Prerequisites
- Ensure the target address is whitelisted. Refer to Whitelist a wallet address to whitelist an address globally for your oganisation.
- Ensure that you have configured the Gas Station. Refer to the Gas Station guide for configuration.
Please note the following when making an API request:
- Consolidate Single Address for non-UTXO chain: Use this option for native coin consolidation.
- Consolidate single token for Non-UTXO chains: Use this option to consolidate tokens. Currently, only one token consolidation is supported per API request.
Note
- The
infoarray in the API success response includes objects containing addresses and responses for asset consolidation features for those addresses, such as insufficient balance, exceeded fee limits, and others.- The error 400: Nothing to consolidate is only applicable when consolidating multiple addresses for non-UTXO chains.