Ctrl+K

Advanced Wallets - Recover Assets

post/api/v1/{coin}/advancedwallet/recovery

Recover assets from an advanced wallet with a balance only in the base address. Works for both multisignature and MPC recoveries.

Retrieves the private keys from KMS using the provided public keys or common keychain, then signs and returns the broadcastable transaction hex.

Note: This endpoint only works when AWM and MBE are running in recovery mode.

To recover assets from an advanced wallet with balances in multiple receive addresses, use Advanced Wallets - Consolidate and Recover Assets.

Use this endpoint only with advanced wallets. For other wallet types, use the Wallet Recovery Wizard.

Path Parameters

  • coinstringRequired

Request Body

isTssRecovery boolean
Set to true to perform a TSS (Threshold Signature Scheme) recovery.
Example: true
tssRecoveryParams object
Parameters specific to TSS recovery. Required when isTssRecovery is true.
commonKeychain string required
The common keychain string used for TSS wallets. Required for TSS recovery.
Example: 0280ec751d3b165a48811b2cc90f90dcf323f33e8bcaadc0341e1e010adcdcf7005afde80dd286d65b6be947af0424dd1e9f7611f3d20e02a4fc84ad8c8b74c1a5
multiSigRecoveryParams object
Parameters specific to standard multisig recovery. Required when isTssRecovery is false (default).
backupPub string required
The backup public key.
Example: xpub661MyMwAqRbcGCNnmzqt3u5KhxmXBHiC78cwAyUMaKJXpFDfHpJwNap6qpG1Kz2SPexKXy3akhPQz7GDYWpHNWkLxRLj6bDxQSf74aTAP9y
bitgoPub string required
The BitGo public key. Required for UTXO coins, optional for others.
Example: xpub661MyMwAqRbcGCNnmzqt3u5KhxmXBHiC78cwAyUMaKJXpFDfHpJwNap6qpG1Kz2SPexKXy3akhPQz7GDYWpHNWkLxRLj6bDxQSf74aTAP9y
userPub string required
The user's public key.
Example: xpub661MyMwAqRbcGCNnmzqt3u5KhxmXBHiC78cwAyUMaKJXpFDfHpJwNap6qpG1Kz2SPexKXy3akhPQz7GDYWpHNWkLxRLj6bDxQSf74aTAP9y
walletContractAddress string required
The wallet contract address. Required for ETH-like recoveries.
Example: 0x1234567890123456789012345678901234567890
recoveryDestinationAddress string required
The address where recovered funds will be sent. Must be a valid address for the coin being recovered.
Example: "9zvKDB8o96QvToQierXtwSfqK9NqaHw7uvmxWsmSrxns" // For SOL
apiKey string
API Key for a block chain explorer. Required for some coins (BTC, ETH) to build a recovery transaction without BitGo.
coinSpecificParams object
Coin-specific recovery options. Different parameters are required based on the coin family: - For UTXO coins (BTC, etc): provide utxoRecoveryOptions. - For EVM chains (ETH, etc): provide evmRecoveryOptions. - For Solana: provide solanaRecoveryOptions.
ecdsaCosmosLikeRecoverySpecificParams object
ecdsaEthLikeRecoverySpecificParams object
evmRecoveryOptions object
EVM-specific recovery parameters for Ethereum and EVM-compatible chains. Used for recovering funds from standard multisig wallets on Ethereum and EVM-compatible chains. Required when recovering ETH, MATIC, BSC, AVAX C-Chain, etc.
solanaRecoveryOptions object
Solana-specific recovery parameters.
utxoRecoveryOptions object
UTXO-specific recovery parameters for Bitcoin & Bitcoin-like cryptocurrencies. Used for recovering funds from standard multisig wallets on UTXO chains. Required when recovering BTC, BCH, LTC, DASH, ZEC, etc.

200 Response

txHex string required
The full signed transaction in hexadecimal format. This transaction can be broadcast to the network to complete the recovery.

400 Response

error string required
The error name
details string required
Error details

404 Response

error string required
The error name
details string required
Error details

409 Response

error string required
The error name
details string required
Error details

422 Response

error string required
The error name
details string required
Error details

500 Response

error string required
The error name
details string required
Error details

501 Response

error string required
The error name
details string required
Error details