Bitcoin Address Balance

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.

Run free trial ↗3 free calls per day with the example input. Paid: $0.003 USDC, no limit.

Call it

import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agentsvc.io/api/v1/proxy/btc-address", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({"address":"bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh","limit":3}),
});
const { data, payment } = await res.json();  // payment.status "settling"; header X-Payment-Settle: sync returns payment.transaction

Input

Field	Type	Description
address *	string	Bitcoin address
limit	integer = 10	Recent transactions, 0 to 25

Output

Field	Type	Description
balance_btc	number
pending_btc	number
usd_value	number
tx_count	number
recent_transactions	array