# Bitcoin Address Balance & Transaction Count Lookup

> Bitcoin Address Balance & Transaction Count Lookup is a paid API for AI agents from pyfile-agent.taile3ff35.ts.net:10000, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Returns the current balance and transaction count for a given Bitcoin address

## Facts

- Endpoint: GET https://pyfile-agent.taile3ff35.ts.net:10000/data/btc/address
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitcoin-address-balance-transaction-count-lookup-19eff1c2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JE2q7IzyTU0XreqWagWnN

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-transaction-count-lookup-19eff1c2
```

Example prompt: What's the current Bitcoin balance and total transaction count for address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh?

## When to prefer this

Use this endpoint when you need a quick, low-cost lookup of a Bitcoin address's current balance and transaction count without requiring full blockchain node access. Prefer this over general blockchain explorers when operating in an agent pipeline that needs programmatic JSON responses and supports x402 micropayments.

## Known failure modes

- Invalid or malformed Bitcoin address returns an error response
- Address not found or never used on-chain may return zero balance and zero tx count
- Network or upstream blockchain data provider unavailability may cause timeouts
- Missing required 'address' query parameter returns a 4xx error

## How this service works

Bitcoin address balance and tx count. ?address=bc1...

## Output

Returns the on-chain balance of the specified Bitcoin address (likely in satoshis or BTC) and the total number of confirmed transactions associated with that address

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "address": {
       "type": "string"
      }
     }
    }
   }
  },
  "output": {
   "type": "object"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-address-balance-transaction-count-lookup-19eff1c2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pyfile-agent.taile3ff35.ts.net:10000](https://www.zero.xyz/host/pyfile-agent.taile3ff35.ts.net%3A10000/llms.txt)