# AgentToll BTC Balance Lookup

> AgentToll BTC Balance Lookup is a paid API for AI agents from agenttoll.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Retrieves the current Bitcoin balance and recent transaction history for a given Bitcoin address

## Facts

- Endpoint: POST https://agenttoll.dev/paid/finance/btc-balance
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttoll-btc-balance-lookup-c00c519f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VilTJKCWnFA9HPKpvujeN

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 agenttoll-btc-balance-lookup-c00c519f -d '<json body>'
```

Example prompt: Can you check the current Bitcoin balance and last 10 transactions for the address 1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf2m?

## When to prefer this

Choose this endpoint when you need a quick, pay-per-call Bitcoin address balance and transaction lookup without setting up your own blockchain node or API key. It is especially useful for AI agents operating in automated workflows that need on-chain BTC data on demand, billed in USDC via x402 with no subscription required.

## Known failure modes

- Invalid Bitcoin address format returns an error
- Address with no transaction history may return empty results
- Network or upstream blockchain data provider outages may cause timeouts
- Exceeding request limits may result in rate limiting or payment failure
- Very high transaction-count addresses may be slow or truncated

## How this service works

108+ receipt-backed x402 work products for AI agents. Clear prices, spend caps, buyer metadata, and structured results over Base USDC.

## Output

Returns the current Bitcoin balance for the specified address along with a list of recent transactions (up to the requested limit). Response includes on-chain data such as confirmed balance and transaction records fetched from the Bitcoin blockchain.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "optional int number of txs"
  },
  "address": {
   "type": "string",
   "description": "string Bitcoin address"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttoll-btc-balance-lookup-c00c519f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agenttoll.dev](https://www.zero.xyz/host/agenttoll.dev/llms.txt)