Express›Advanced Wallets

POST

Advanced Wallets - Consolidate Unspents

Builds, signs, and sends a transaction to consolidate unspents all in 1 call. Consolidating unspents is only for UTXO-based assets.

Retrieves the private key from KMS using the provided public key, then signs and broadcasts the transaction.

Use this endpoint only with advanced wallets. For other wallet types, use Consolidate unspents (simple).

Path Params

  • walletId string required
  • coin string required

Body Params

object

  • pubkey string required
    Public key of the key used for signing multisig transactions
  • source string enum required
    The key to use for signing the transaction
    userbackup
  • feeRate number
    Custom fee rate (in base units) per kilobyte
  • maxFeeRate number
    Maximum fee rate (in base units) per kilobyte
  • maxFeePercentage number
    Maximum fee percentage
  • feeTxConfirmTarget number
    Fee transaction confirmation target
  • bulk boolean
    Enable bulk processing
  • minValue string or number
    Minimum value for unspents
  • maxValue string or number
    Maximum value for unspents
  • minHeight number
    Minimum block height
  • minConfirms number
    Minimum confirmations required
  • enforceMinConfirmsForChange boolean
    Enforce minimum confirmations for change outputs
  • limit number
    Limit the number of unspents to process
  • numUnspentsToMake number
    Number of unspents to make
  • targetAddress string
    Target address for consolidation

Responses

200
OK

Response Body

object

  • tx string required
  • txid string required
400
Bad Request

Response Body

object

  • error string required
    The error name
  • details string required
    Error details
404
Not Found

Response Body

object

  • error string required
    The error name
  • details string required
    Error details
409
Conflict

Response Body

object

  • error string required
    The error name
  • details string required
    Error details
422
Unprocessable Entity

Response Body

object

  • error string required
    The error name
  • details string required
    Error details
500
Internal Server Error

Response Body

object

  • error string required
    The error name
  • details string required
    Error details
501
Not Implemented

Response Body

object

  • error string required
    The error name
  • details string required
    Error details