Bitcoin address balance and activity
Balance and activity of any Bitcoin mainnet address (legacy, P2SH or bech32): confirmed balance in sats and BTC, unconfirmed pending amount, total received and sent, and transaction counts. Use for payment verification, checking whether a deposit arrived, and wallet monitoring.
Inputs
| Name | Type | Description |
|---|---|---|
address (required) | string | Bitcoin mainnet address (1..., 3... or bc1...) |
Request
Over HTTP, with a card key from /credits:
curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/btc-address?address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
Or one of your 25 free calls, no key:
curl "https://agent-data-tools.revmesh2074.workers.dev/btc-address?address=bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh&trial=1"
Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum, Monad, World Chain or Tempo) and retries.
Example result
{
"network": "bitcoin",
"address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
"balanceSats": 392247777,
"balanceBtc": 3.92247777,
"pendingSats": 0,
"totalReceivedBtc": 16.79253616,
"totalSentBtc": 12.87005839,
"transactions": 1138,
"pendingTransactions": 0
}
From an AI agent (MCP)
Add the MCP server to Claude, Cursor or any MCP client. This tool is btc_address, and the first 25 successful calls are free:
https://agent-data-tools.revmesh2074.workers.dev/mcp