{"uid":"cap_o317GgTrRyuipg7WVuKQl","slug":"bitcoin-address-balance-confirmed-unconfirmed-79e27fc6","name":"Bitcoin Address Balance (Confirmed & Unconfirmed)","description":"Bitcoin address balance, confirmed and unconfirmed — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/btc-address?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-address","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_z0qv-O3q4nSdMzVmSOqaD","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 the confirmed and unconfirmed BTC balance for a given Bitcoin address via the UnyKorn Operator Network.","exampleAgentPrompt":"What's the current Bitcoin balance — both confirmed and unconfirmed — for address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh?","exampleUseCases":[{"title":"Verify payment received on-chain","prompt":"Check the confirmed and unconfirmed BTC balance on address 1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf Na to see if a payment has arrived yet."},{"title":"Monitor wallet before withdrawal","prompt":"Before I send funds, can you check the confirmed balance on my Bitcoin address bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq so I know what's available?"},{"title":"Audit a counterparty's Bitcoin address","prompt":"I need to audit this Bitcoin address 3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy — can you tell me how much confirmed and unconfirmed BTC is sitting there right now?"}],"resultDescription":"Returns a JSON object with ok status, type field set to 'btc-address', a receipt object containing transaction hash, USD amount paid, and receipt ID, plus a generated_at ISO8601 timestamp. The balance data itself (confirmed and unconfirmed BTC amounts) is included in the response payload.","failureModes":["Invalid or malformed Bitcoin address returns an error or empty result","Network timeout if the upstream Bitcoin node is unresponsive","Address with no transaction history may return zero balances","Payment failure (x402 protocol) prevents the query from executing","Rate limiting or quota exceeded on the operator network"],"whenToPreferThis":"Choose this endpoint when you need a quick, pay-per-call lookup of both confirmed and unconfirmed BTC balances for a specific Bitcoin address without setting up your own node or maintaining an API key subscription. It is ideal for agents that need on-demand balance checks as part of payment verification workflows, audit tasks, or wallet monitoring — especially in x402-enabled micropayment environments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:55:46.409Z","isFirstParty":false,"canonicalSlug":"bitcoin-address-balance-confirmed-unconfirmed-79e27fc6"}