{"uid":"cap_H4l6JGaTNXixyyfT7C9A3","slug":"bitcoin-address-balance-fc985cde","name":"Bitcoin Address Balance","description":"Bitcoin address lookup for agents: confirmed and pending balance in BTC and USD, total received and sent, transaction count and the latest transactions with net amount, confirmations and fee. Works for bc1 (SegWit, Taproot), 1 and 3 addresses on Bitcoin mainnet. Use to check a payment, a treasury or a counterparty wallet.","url":"https://agentsvc.io/api/v1/proxy/btc-address?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":10,"description":"Recent transactions, 0 to 25"},"address":{"type":"string","description":"Bitcoin address"}}},"responseSchema":{"type":"json","example":{"data":{},"success":true}},"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_EXhFZ8g0SeE0G053gqcY_","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":"Looks up confirmed and pending BTC balance, total received/sent, transaction count, and recent transactions for a Bitcoin address","exampleAgentPrompt":"Can you check the balance and last 5 transactions for Bitcoin address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh — I want to see both confirmed and pending BTC amounts along with the USD value?","exampleUseCases":[{"title":"Verify incoming customer payment","prompt":"I need to confirm that the payment from our customer landed — can you check if Bitcoin address bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq has received any new transactions in the last 10 blocks and what the confirmed balance is right now?"},{"title":"Monitor treasury wallet balance","prompt":"Check our company treasury wallet at 3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy and tell me the total confirmed BTC balance, the USD equivalent, and how many transactions it has received in total."},{"title":"Audit counterparty wallet before deal","prompt":"Before I finalize this deal, can you look up Bitcoin address 1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf Na and show me its full transaction history — I want to see total sent, total received, and the last 25 transactions with fees and confirmations."}],"resultDescription":"Returns confirmed and pending balance in both BTC and USD, total BTC received and sent over the address's lifetime, overall transaction count, and a list of recent transactions (up to 25) each with net amount, number of confirmations, and fee paid.","failureModes":["Invalid Bitcoin address format returns an error (non-bc1/1/3 addresses, testnet addresses)","Address with no transactions may return zero balances","Rate limiting or upstream blockchain data provider downtime","Limit parameter out of range (above 25 or below 0) may return an error","Mainnet-only — submitting a testnet address will fail or return incorrect data"],"whenToPreferThis":"Use this endpoint when you need on-chain Bitcoin balance and transaction data for a specific address, particularly when you need both BTC and USD values together with per-transaction details like fees and confirmations in a single call. Prefer it over raw blockchain explorers when you need structured, agent-ready JSON output. Suitable for bc1 (SegWit/Taproot), legacy (1xxx), and P2SH (3xxx) mainnet addresses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T06:47:39.584Z","isFirstParty":false,"canonicalSlug":"bitcoin-address-balance-fc985cde"}