{"uid":"cap_acdJB_S5uQwQt_0Vi3iWY","slug":"bitcoin-address-checker-048c6947","name":"Bitcoin Address Checker","description":"Validate a Bitcoin mainnet address and report its type, confirmed and pending balance, transaction count and USD value.","url":"https://bitcoin-network.x402tookit.com/btc-address-check?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Bitcoin mainnet address (bc1... or legacy)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"type":{"type":["null","string"]},"source":{"type":["null","string"]},"address":{"type":["null","string"]},"network":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"priceUsd":{"type":["null","number"]},"usdValue":{"type":["null","number"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"totalSentSats":{"type":["null","number"]},"pendingTxCount":{"type":["null","number"]},"confirmedTxCount":{"type":["null","number"]},"totalReceivedSats":{"type":["null","number"]},"confirmedBalanceBtc":{"type":["null","number"]},"confirmedBalanceSats":{"type":["null","number"]},"pendingBalanceChangeSats":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aILrL2bzoJLOm4fJgChcm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates a Bitcoin mainnet address and returns its type, confirmed and pending balances in BTC and satoshis, transaction counts, and current USD value.","exampleAgentPrompt":"Can you check the balance and transaction count for the Bitcoin address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh and tell me its type and current USD value?","exampleUseCases":[{"title":"Verify incoming payment receipt","prompt":"I need to confirm that the Bitcoin address bc1q9wdnzxlnq7glsxkl4s6qj7p3k8y5m6z2h3v0f actually received funds — can you check its confirmed balance and how many transactions it has?"},{"title":"Validate customer-submitted wallet address","prompt":"A customer gave us the Bitcoin address 1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf Na for a refund — can you validate whether it's a real mainnet address, what type it is, and what its current balance is?"},{"title":"Monitor high-value wallet balance in USD","prompt":"What's the current USD value of the BTC sitting at address bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h and how many confirmed transactions does it have?"}],"resultDescription":"Returns a JSON object containing the validated Bitcoin address, its type (e.g. p2pkh, p2wpkh), network (mainnet), confirmed balance in BTC and satoshis, pending balance change in satoshis, confirmed and pending transaction counts, total sent and received satoshis, current BTC price in USD, USD value of the balance, a verdict and summary, data source URL, timestamp, and any degraded-mode or disclaimer flags.","failureModes":["Invalid or malformed address returns a negative verdict with reasons explaining the checksum or format failure","Address not found on-chain returns zero balances with confirmed counts of zero","Upstream blockchain data provider unavailable may set degraded=true with partial or null balance fields","Non-mainnet addresses (testnet, regtest) may be rejected or flagged as wrong network","Missing required query parameter 'address' returns a 400-level error"],"whenToPreferThis":"Choose this endpoint when you need a combined on-chain lookup and address validation in a single call — it returns balance, transaction counts, USD value, and address type together. Prefer it over a pure offline validator when live balance data is needed, and over a generic blockchain explorer API when you want a structured, agent-friendly JSON response with a verdict and USD conversion already included.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:34:15.058Z","isFirstParty":false,"canonicalSlug":"bitcoin-address-checker-048c6947"}