Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

get_script_utxos

Enumerate unspent outputs locked by an arbitrary output script. Allows querying UTXOs locked by scripts beyond plain address-hash form (e.g. HTLC, multisig, covenant scripts).

Params

{ "script_hex": "<hex-encoded output script, ≤ 65535 bytes>" }

Result

{
  "script_hex": "<echo of the queried script_hex>",
  "tip_height": 5553,
  "truncated": false,
  "utxos": [
    {
      "tx_id": "fb8a634f...8c",
      "output_index": 0,
      "value": 1000000000,
      "script_len": 142,
      "height": 5400,
      "is_coinbase": false
    }
  ]
}

Notes

  • script_len is the byte length of the queried script (constant per response — it reflects the request, not per-UTXO state).
  • truncated, coinbase maturity, confirmation count, and 1000-entry cap follow the same semantics as get_address_utxos.

Counts against the UTXO-scan rate limit (30 / min / IP). Request body cap is 200 KB (script_hex is up to 131 070 hex chars, since each byte encodes to two hex chars).