# Bitcoin Address Info — Balance & Transaction History

> Bitcoin Address Info — Balance & Transaction History is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-16).

Returns confirmed/unconfirmed balance, total received/spent, mempool delta, up to 20 recent transactions with fees and timestamps, and address type classification for any Bitcoin address.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/bitcoin-address-info
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/proxy-suverse-io-f188cb2f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__NlkIipDU0wETahhv7U_G

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 proxy-suverse-io-f188cb2f -d '<json body>'
```

Example prompt: Can you pull up the balance and last 20 transactions for Bitcoin address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh — I want to see the confirmed BTC balance, any unconfirmed mempool activity, and what type of address it is?

## When to prefer this

Use this endpoint when you need a comprehensive snapshot of a Bitcoin address including balance, address type classification, and recent transaction history in a single call. Prefer this over raw block explorer scraping or multi-call node RPC when you need structured, agent-ready output with mempool awareness and fee data.

## Known failure modes

- Invalid Bitcoin address format — returns error indicating malformed address
- Address not found on-chain (zero activity) — returns zero balances and empty transaction list
- Mempool or node connectivity issues — may return stale or partial data
- Rate limiting or payment failure — returns 402 or 429 status if x402 payment is not processed

## How this service works

Bitcoin address balance + tx history. Returns confirmed BTC and sats balance, unconfirmed mempool delta, total received/spent, tx counts, up to 20 recent tx with timestamps and fees, address type (p2pkh p2sh p2wpkh p2tr). AI agent whale tracker, BTC wallet API, on-chain analytics.

## Output

Returns confirmed balance in BTC and satoshis, unconfirmed mempool delta, total received and spent amounts, confirmed and mempool transaction counts, up to 20 recent transactions with timestamps and fees, and the address type classification (p2pkh, p2sh, p2wpkh, or p2tr).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/proxy-suverse-io-f188cb2f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)