# Bitcoin Address Checker

> Bitcoin Address Checker is a paid API for AI agents from bitcoin-network.x402tookit.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-30).

Validates a Bitcoin mainnet address and returns its type, confirmed and pending balances in BTC and satoshis, transaction counts, and current USD value.

## Facts

- Endpoint: GET https://bitcoin-network.x402tookit.com/btc-address-check?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitcoin-address-checker-048c6947
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_acdJB_S5uQwQt_0Vi3iWY

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-checker-048c6947
```

Example prompt: Can you check the balance and transaction count for the Bitcoin address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh and tell me its type and current USD value?

## When to prefer this

Choose this endpoint when you need a combined on-chain lookup and address validation in a single call — it returns balance, transaction counts, USD value, and address type together. Prefer it over a pure offline validator when live balance data is needed, and over a generic blockchain explorer API when you want a structured, agent-friendly JSON response with a verdict and USD conversion already included.

## Known failure modes

- Invalid or malformed address returns a negative verdict with reasons explaining the checksum or format failure
- Address not found on-chain returns zero balances with confirmed counts of zero
- Upstream blockchain data provider unavailable may set degraded=true with partial or null balance fields
- Non-mainnet addresses (testnet, regtest) may be rejected or flagged as wrong network
- Missing required query parameter 'address' returns a 400-level error

## How this service works

Validate a Bitcoin mainnet address and report its type, confirmed and pending balance, transaction count and USD value.

## Output

Returns a JSON object containing the validated Bitcoin address, its type (e.g. p2pkh, p2wpkh), network (mainnet), confirmed balance in BTC and satoshis, pending balance change in satoshis, confirmed and pending transaction counts, total sent and received satoshis, current BTC price in USD, USD value of the balance, a verdict and summary, data source URL, timestamp, and any degraded-mode or disclaimer flags.

## 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",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "Bitcoin mainnet address (bc1... or legacy)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "type": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "address": {
       "type": [
        "null",
        "string"
       ]
      },
      "network": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "priceUsd": {
       "type": [
        "null",
        "number"
       ]
      },
      "usdValue": {
       "type": [
        "null",
        "number"
       ]
      },
      "sourceUrl": {
       "type": [
        "null",
        "string"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "totalSentSats": {
       "type": [
        "null",
        "number"
       ]
      },
      "pendingTxCount": {
       "type": [
        "null",
        "number"
       ]
      },
      "confirmedTxCount": {
       "type": [
        "null",
        "number"
       ]
      },
      "totalReceivedSats": {
       "type
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-address-checker-048c6947/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bitcoin-network.x402tookit.com](https://www.zero.xyz/host/bitcoin-network.x402tookit.com/llms.txt)