analyzepsbt - Bitcoin

Example code for the analyzepsbt JSON_RPC method. Сomplete guide on how to use analyzepsbt JSON-RPC in GetBlock Web3 documentation.

This method analyzes and provides information about the current status of a PSBT (Partially Signed Bitcoin Transaction) and its inputs.

Parameters

Parameter	Type	Required	Description
psbt	string	Yes	A base64 string of a PSBT.

Request

Curl

curl --location --request POST 'https://go.getblock.io/<ACCES_TOKEN>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "analyzepsbt",
    "params": [
        "cHNidP8BAEICAAAAATJIj43goxJCsLjdKM5Uly44S8Vp6cim1VW89Rx5fFPpAAAAAAD/////AQAAAAAAAAAABmoEAAECAwAAAAAAAAA="
    ],
    "id": "getblock.io"
}'

Axios

Request

Rust

Response

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": {
        "inputs": [
            {
                "has_utxo": true,
                "is_final": false,
                "next": "signer",
                "missing": {
                    "signatures": [
                        "02c7b8...8e1f"
                    ]
                }
            }
        ],
        "estimated_vsize": 147,
        "estimated_feerate": 0.00001000,
        "fee": 0.00000147,
        "next": "signer"
    }
}

Response Parameters

Field	Type	Description
inputs	array	Array of objects with information about each input.
inputs[].has_utxo	boolean	Whether a UTXO is provided for this input.
inputs[].is_final	boolean	Whether the input is finalized.
inputs[].next	string	Role of the next person that this input needs to go to.
inputs[].missing	object	Object containing missing items needed for signing.
inputs[].missing.signatures	array	Array of public keys whose corresponding signature is missing.
estimated_vsize	number	Estimated virtual size of the final transaction in vbytes.
estimated_feerate	number	Estimated feerate of the final transaction in BTC/kvB.
fee	number	The transaction fee paid if all UTXOs are provided.
next	string	Role of the next person that this PSBT needs to go to.

Use Case

The analyzepsbt method is essential for:

• Checking the completion status of a PSBT before signing

• Identifying missing signatures or other data

• Estimating transaction fees before finalizing

• Debugging PSBT construction issues

• Multi-signature workflow management

• Determining the next step in the PSBT workflow

Error Handling

Status Code	Error Message	Cause
403	RBAC: access denied	Missing or invalid ACCESS-TOKEN.
-22	Invalid params	The PSBT string is malformed or invalid base64.

Integration Notes

The analyzepsbt method helps developers:

• Build multi-party signing workflows

• Validate PSBTs before broadcasting

• Calculate accurate fee estimates

• Track signing progress in hardware wallet integrations

• Implement PSBT-based payment protocols