{"uid":"cap_l5ptZ-IJ8e9fFwn5H3izz","slug":"bitcoin-address-balance-647b1527","name":"Bitcoin Address Balance","description":"Balance of a Bitcoin address (confirmed and pending), total received and sent, transaction count and its latest 10 transactions with net amount. Use to check a BTC payment or wallet.","url":"https://bess-x402.onrender.com/v1/crypto/btc-address?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Bitcoin address (bc1..., 1..., 3...)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_R7WEaBvp0MilFZcSAzCT1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns confirmed and pending balance, total received/sent, transaction count, and the latest 10 transactions for a given Bitcoin address.","exampleAgentPrompt":"Can you check the balance and latest transactions for the Bitcoin address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh? I want to see if a payment I'm expecting has arrived.","exampleUseCases":[{"title":"Verify incoming BTC payment","prompt":"I sent a Bitcoin payment to bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq a few hours ago — can you check if it's confirmed yet and show me the recent transactions?"},{"title":"Monitor merchant wallet receipts","prompt":"Check the balance and incoming transactions for my Bitcoin merchant address 3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy and tell me the total received and how many transactions have come in."},{"title":"Audit wallet activity before sweep","prompt":"Before I sweep funds, can you pull the confirmed balance, total sent, and the last 10 transactions for the Bitcoin wallet 1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf NA so I can verify everything looks clean?"}],"resultDescription":"Returns the Bitcoin address's confirmed and pending balance (in BTC), total amount ever received and sent, total transaction count, and a list of the latest 10 transactions each with a net amount (positive for received, negative for sent).","failureModes":["Invalid or malformed Bitcoin address format returns an error","Address with no transaction history may return zero balances and empty transaction list","Network timeouts if the underlying blockchain data source is slow or unavailable","Rate limiting or payment failure if the x402 payment is not processed correctly"],"whenToPreferThis":"Choose this endpoint when you need a quick, paid, on-demand lookup of a single Bitcoin address's balance and recent transaction history without setting up a full blockchain node or indexer. Ideal for payment verification, wallet auditing, or confirming receipt of a BTC transfer in an automated agent workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:49:10.359Z","isFirstParty":false,"canonicalSlug":"bitcoin-address-balance-647b1527"}