Get maximum spendable


Returns the maximum amount that can be spent with a single transaction on the wallet.

The maximum spendable amount can differ from a wallet’s total balance. A transaction can only use up to 200 unspents. Wallets that have more than 200 unspents cannot spend the full balance in one transaction. Additionally, the value returned for the maximum spendable amount accounts for the current fee level by deducting the estimated fees. The amount will only be calculated based on the unspents that fit the parameters passed.

Path Parameters

  • coinstringRequired
    A cryptocurrency or token ticker symbol.
    Example: "btc"
  • walletIdstringRequired
    Example: "59cd72485007a239fb00282ed480da1f"
    Pattern: ^[0-9a-f]{32}$

Query Parameters

  • allTokensboolean
    Include data for all subtokens (i.e. ERC20 Tokens, Stellar Tokens)
  • enforceMinConfirmsForChangeboolean
    Enforces "minConfirms" on change inputs
  • feeRateinteger
  • limitintegerDefault: 25
    Maximum number of results to return. If the result set is truncated, use the "nextBatchPrevId" value to get the next batch.
  • maxFeeRateinteger
  • maxValue
    Maximum value of each unspent in base units (e.g. satoshis). For doge, only string is allowed.
  • minConfirmsinteger
    Minimum number of confirmations for the collected inputs. Only applies to external unspents. Use "enforceMinConfirmsForChange" to filter change as well.
  • minHeightnumber
    Minimum block height of the unspents
  • numBlocksintegerDefault: 2
    Sets the target estimated number of blocks for a confirmation

200 Response

maximumSpendable string
Example: 19948310

400 Response

One of
error string required
Human-readable error message
requestId string required
Client request id
context object
Properties that apply to a specific error name
name string required
Error code