# Bitcoin Address Balance

> Bitcoin Address Balance is a paid API for AI agents from agentsvc.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-16).

Looks up confirmed and pending BTC balance, total received/sent, transaction count, and recent transactions for a Bitcoin address

## Facts

- Endpoint: POST https://agentsvc.io/api/v1/proxy/btc-address?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitcoin-address-balance-fc985cde
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_H4l6JGaTNXixyyfT7C9A3

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability bitcoin-address-balance-fc985cde -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "description": "Recent transactions, 0 to 25"
  },
  "address": {
   "type": "string",
   "description": "Bitcoin address"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-address-balance-fc985cde/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentsvc.io](https://www.zero.xyz/host/agentsvc.io/llms.txt)