{"uid":"cap_c8kS4nOQgoTaT-hEEu5xf","slug":"bitcoin-address-balance-utxo-lookup-eebe5fd0","name":"Bitcoin Address Balance & UTXO Lookup","description":"Balance and unspent outputs for a Bitcoin address. Returns confirmed and mempool balance, funded and spent totals, transaction count and a capped UTXO set for a legacy, p2sh or bech32 address. Informational, not advice.","url":"https://api.agentstools.dev/btc/address","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Bitcoin mainnet address (legacy 1.., p2sh 3.., or bech32 bc1..)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_z_JhS1sx5-YyQlgd7hgXf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns confirmed and mempool balance, funded/spent totals, transaction count, and a capped UTXO set for a Bitcoin address (legacy, P2SH, or bech32).","exampleAgentPrompt":"What's the current confirmed and mempool balance for the Bitcoin address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh, and how many UTXOs does it have?","exampleUseCases":null,"resultDescription":"A JSON object containing the confirmed balance, mempool (unconfirmed) balance, total funded amount, total spent amount, transaction count, and a capped list of unspent transaction outputs (UTXOs) for the queried Bitcoin address.","failureModes":["Invalid or malformed Bitcoin address returns a 400 error","Address not found on mainnet (never used) may return zero balances with empty UTXO set","Testnet addresses will not be recognized (mainnet only)","UTXO set is capped — addresses with very large UTXO sets will receive a truncated list","Network or upstream node unavailability may return 5xx errors","Missing required 'address' query parameter returns a 400 validation error"],"whenToPreferThis":"Use this endpoint when you need a quick, combined view of a Bitcoin address's balance (both confirmed and mempool), funding history, and available UTXOs without building or querying your own Bitcoin node. Ideal for agents checking wallet balances, verifying incoming payments, or inspecting UTXO availability before constructing transactions. Supports all three major address formats (legacy, P2SH, bech32).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:12:14.762Z","isFirstParty":false}