# Vextorium Bitcoin Address Balance & Transaction Lookup

> Vextorium Bitcoin Address Balance & Transaction Lookup is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-11).

Returns balance (BTC, sats, USD), mempool pending amount, total received/sent, transaction count, and recent transactions with net effect and confirmations for any Bitcoin address type.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/bitcoin-address?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-bitcoin-address-balance-transaction-lookup-9b809b9b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DxVdJ6uPn153fnHFf-s-5

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 vextorium-bitcoin-address-balance-transaction-lookup-9b809b9b -d '<json body>'
```

Example prompt: What's the current balance of Bitcoin address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh in BTC, sats, and USD, and show me the last 5 transactions with their net effect and confirmations?

## When to prefer this

Choose this endpoint when you need a comprehensive on-chain snapshot of any Bitcoin address — including all four address formats (legacy 1..., P2SH 3..., SegWit bc1q..., Taproot bc1p...) — with balance in multiple denominations, live USD conversion, mempool awareness, and per-transaction net effect in a single call. Prefer this over raw block explorer APIs when you want structured, agent-friendly JSON without parsing HTML or running your own node.

## Known failure modes

- Invalid or malformed Bitcoin address returns an error
- Address not found on-chain returns empty or null balance
- Network connectivity issues with Blockstream Esplora return a timeout or service error
- Limit parameter out of range may return validation error
- Mempool data may lag slightly behind real-time node state

## How this service works

Balance of any Bitcoin address (legacy, P2SH, SegWit or Taproot) in BTC, sats and USD, pending mempool amount, total received and sent, transaction count and the latest transactions with net effect and confirmations.

## Output

Returns a JSON object containing the address type (legacy/P2SH/SegWit/Taproot), current balance in BTC, satoshis, and USD, pending mempool amount, total BTC received and sent, total transaction count, current BTC/USD price, and an array of recent transactions each with txid, date, net BTC, fee in sats, confirmed status, and confirmation 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "address"
     ],
     "properties": {
      "limit": {
       "type": "integer"
      },
      "address": {
       "type": "string",
       "description": "Bitcoin address (1..., 3... or bc1...)"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "last": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "date": {
          "type": [
           "null",
           "string"
          ]
         },
         "txid": {
          "type": [
           "null",
           "string"
          ]
         },
         "net_btc": {
          "type": [
           "null",
           "number"
          ]
         },
         "fee_sats": {
          "type": [
           "null",
           "number"
          ]
         },
         "confirmed": {
          "type": [
           "boolean",
           "null"
          ]
         },
         "confirmations": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "type": {
       "type": [
        "string",
        "null"
       ]
      },
      "source": {
       "type": [
        "string",
        "null"
       ]
      },
      "address": {
       "type": [
        "string",
        "null"
       ]
      },
      "balance": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "btc": {
         "type": [
          "number",
          "null"
         ]
        },
        "usd": {
         "type": [
          "number",
          "null"
         ]
        },
        "sats": {
         "type": [
          "number",
          "n
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "last": [
   {
    "date": "2026-09-28T12:34:10+00:00",
    "txid": "5420695c11ddebff09fd2786c16b8481b2187cb750458880ddd9e71cbf0da0e8",
    "net_btc": 0.00000546,
    "fee_sats": 680,
    "confirmed": true,
    "confirmations": 644
   },
   {
    "date": "2026-09-15T16:26:34+00:00",
    "txid": "9b46bfde6702335f68f6a78eaf7cab35875598c9584e95f0e3442f3b1e82aa82",
    "net_btc": 0.03025698,
    "fee_sats": 10000,
    "confirmed": true,
    "confirmations": 2487
   }
  ],
  "type": "segwit",
  "source": "Blockstream Esplora (public Bitcoin node)",
  "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
  "balance": {
   "btc": 3.92247777,
   "usd": 331494.8,
   "sats": 392247777
  },
  "transactions": 1138,
  "btc_price_usd": 84511.58149319161,
  "total_sent_btc": 12.87005839,
  "mempool_pending": {
   "btc": 0,
   "sats": 0
  },
  "total_received_btc": 16.79253616
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-bitcoin-address-balance-transaction-lookup-9b809b9b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)
