# 2s.io Bitcoin Address Summary

> 2s.io Bitcoin Address Summary is a paid API for AI agents from 2s.io, paid per call via x402, $0.0036/call, status unknown (last checked 2026-09-15).

Returns confirmed balance, total received/sent, transaction count, and pending mempool data for any Bitcoin address (legacy, SegWit, or Taproot)

## Facts

- Endpoint: GET https://2s.io/api/crypto/btc-address
- Price: $0.0036/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-bitcoin-address-summary-03d6d329
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TDq745vkDvT0LtAOsh2_D

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 2s-io-bitcoin-address-summary-03d6d329
```

Example prompt: What's the confirmed BTC balance and total number of transactions for Bitcoin address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh? Also tell me if there's anything pending in the mempool.

## When to prefer this

Use this endpoint when you need a comprehensive on-chain summary of a Bitcoin address including balance, transaction history counts, and mempool status — especially when your existing on-chain reads are EVM-only and you need BTC coverage. Covers all address formats: legacy (1...), P2SH (3...), native SegWit (bc1q...), and Taproot (bc1p...).

## Known failure modes

- Invalid or malformed Bitcoin address returns an error
- Address string shorter than 20 or longer than 100 characters rejected by schema validation
- Network timeout or upstream blockchain node unavailability
- Address with no transaction history may return zero values
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Bitcoin address summary (free/keyless): confirmed balance (sats + BTC), total received/sent, transaction count, funded/spent output counts, and pending mempool balance + tx count. Works for any BTC address (legacy, SegWit, Taproot). Net-new — our on-chain reads were EVM-only.

## Output

Returns a JSON object with the Bitcoin address's confirmed balance in both satoshis and BTC, total amounts received and sent, transaction count, number of funded and spent outputs, and any pending mempool balance and transaction count.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "maxLength": 100,
       "minLength": 20,
       "description": "Bitcoin address (1.../3.../bc1...)."
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

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