Split

Split UTXO

POST /utxo/split

This endpoint handles the creation of a PSBT that splits a Bitcoin address's UTXOs into smaller ones. It validates the request, constructs the transaction, and returns the result.

• Validates address, count, value, feeRate, and optional publicKey.

• Splits UTXOs into the specified number of outputs with equal value.

• Returns the unsigned PSBT (base64) ready for signing and broadcasting.

Body

Name	Type	Description
inAddress*	string	Bitcoin address to get the UTXOs from
outAddress (optional)	string	Bitcoin address to send the splits. If not set then UTXOs will be sent to inAddress
splits*	array: { value: number, count: number }	Array containing split objects
value*	number	Value of each UTXO split
feeRate*	number	Fee rate in sats/vByte
publicKey	string	Address associated public key, needed for p2sh only

Example:

{
  "inAddress": "tb1qr4skmn8l78qff20n05lyh5dwuu8jj22xjg0tvu",
  "outAddress": "tb1qr4sw...",
  "splits": [
    {
        "value": 600,
        "count": 2
    },
    {
        "value": 1000,
        "count": 3
    }
  ],
  "feeRate": "10",
  "publicKey": "03725d3f1891f9f91a105c7558f4dcac784430ed119df43896f66314b8a8adcd31"
}

Response

200

{
  "psbt": "cHNidP8BAJACAAAA..."
}

500

{
  "error": "Internal server error"
}

400

{
  "error": "Invalid request"
}