gettxout

gettxout looks up a single unspent transaction output — a UTXO — in Bitcoin's UTXO set, the collection of spendable coins that the chain tracks instead of account balances. Given a transaction id and an output index, it returns the output's value (in BTC), its scriptPubKey, the number of confirmations, and whether it came from a coinbase; if that output has already been spent or never existed, it returns null. This is the core read for confirming a coin is still live before you spend it. Send the txid and vout index to https://bitcoin.therpc.io/YOUR_API_KEY.

Use cases

• Check whether a specific output is still unspent before you build a transaction that spends it.
• Read a UTXO's value and scriptPubKey to drive coin selection and fee planning.
• Pass include_mempool true to catch outputs already spent by an unconfirmed mempool transaction — those return null.

Parameters

Response

Example request

1curl https://bitcoin.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5  "jsonrpc": "1.0",
6  "id": "therpc",
7  "method": "gettxout",
8  "params": [
9    "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b",
10    0,
11    true
12  ]
13}'

Errors & troubleshooting

Common pitfalls

• This call only queries the live UTXO set, so a spent output returns null — to inspect an output that has already been spent, use getrawtransaction instead.
• The value field here is denominated in BTC, unlike getblockstats, which returns amounts in satoshis — do not mix the two scales.
• A null result is the normal "not unspent" answer, not an error, so branch on null rather than treating it as a failure.

Supported networks

• Mainnet
• Testnet

See also

• gettxoutproof
• getrawtransaction
• decodescript