{"uid":"cap_Qs5Tk6msTeWkpaZAagMmP","slug":"bitcoin-utxo-lookup-by-address-90fce880","name":"Bitcoin UTXO Lookup by Address","description":"Every spendable UTXO at a Bitcoin address — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/btc-utxos?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"address":{"type":"string"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"btc-utxos","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.005,"receipt_id":"g402-<16hex>"},"generated_at":"<iso8601>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hnQK4LU6hpvAC5dk3B-Xg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all spendable unspent transaction outputs (UTXOs) for a given Bitcoin address","exampleAgentPrompt":"What are all the spendable UTXOs for Bitcoin address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh? I need the full list of unspent outputs before I build a transaction.","exampleUseCases":[{"title":"Coin selection before sending Bitcoin","prompt":"I'm about to send 0.05 BTC from bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq — can you fetch all the spendable UTXOs at that address so I can pick the right inputs for the transaction?"},{"title":"Wallet balance reconstruction from UTXOs","prompt":"Can you pull every unspent output for bc1q34aq5auelf0ntp9haecxa4e4exj3eur4z0nkrv so I can add them up and verify the total spendable balance?"},{"title":"UTXO consolidation planning","prompt":"I need to consolidate UTXOs at bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h — fetch all the spendable outputs so I can figure out how many inputs I'll need and estimate the fee."}],"resultDescription":"A JSON object with ok:true, a type of 'btc-utxos', a receipt object containing the transaction hash, USD amount charged, and receipt ID, plus a generated_at ISO8601 timestamp. The core payload lists all spendable UTXOs associated with the queried Bitcoin address, enabling coin selection, balance calculation, or transaction construction.","failureModes":["Invalid Bitcoin address format returns an error response","Address with no UTXOs returns an empty list","Network or node connectivity issues may return a timeout or service error","Malformed request body (missing params.address) returns a validation error","Payment failure via x402 protocol prevents the call from being processed"],"whenToPreferThis":"Choose this endpoint when you need a complete, current list of all spendable UTXOs for a Bitcoin address — particularly useful before constructing a raw transaction, performing coin selection, or auditing a wallet's spendable balance. It is part of the UnyKorn operator network alongside complementary Bitcoin utilities (fee rates, block height, script identification), making it a good fit when you are already using that network for other Bitcoin on-chain queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:55:27.858Z","isFirstParty":false,"canonicalSlug":"bitcoin-utxo-lookup-by-address-90fce880"}