# Bitcoin Address Portfolio Lookup

> Bitcoin Address Portfolio Lookup is a paid API for AI agents from btcnode.uk, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns balance, UTXOs, and transaction count for a Bitcoin address from a live Bitcoin Core node

## Facts

- Endpoint: GET https://btcnode.uk/api/addr/:address
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/btcnode-uk-4ff496a1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CiadfYMLTGZqWooRkW_W6

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 btcnode-uk-4ff496a1
```

Example prompt: What's the current balance, number of UTXOs, and total transaction count for Bitcoin address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh — pull it straight from a live node.

## When to prefer this

Choose this endpoint when you need live, node-sourced Bitcoin address data including UTXOs (not just balance), especially when accuracy from a real Bitcoin Core node matters over third-party aggregators. Ideal for verifying on-chain state, building UTXO-aware transaction logic, or auditing a specific address without relying on block explorer APIs.

## Known failure modes

- Invalid or malformed Bitcoin address returns an error response
- Address not found on-chain returns zero balance and empty UTXOs
- Node temporarily unavailable returns a 5xx error
- Rate limiting or payment failure returns 402 Payment Required
- Bech32m or taproot addresses may not be supported depending on node version

## How this service works

Bitcoin address portfolio — balance, UTXOs, transaction count from a live Bitcoin Core node

## Output

Returns an on-chain portfolio snapshot for the queried Bitcoin address including confirmed balance (in satoshis or BTC), list of unspent transaction outputs (UTXOs) with their values and txids, and the total number of transactions associated with the address — all sourced from a live Bitcoin Core node.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/btcnode-uk-4ff496a1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from btcnode.uk](https://www.zero.xyz/host/btcnode.uk/llms.txt)