# Bitcoin Address & Transaction Tracer (Onchain Risk Checks)

> Bitcoin Address & Transaction Tracer (Onchain Risk Checks) is a paid API for AI agents from agent-data.centorprat.workers.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-30).

Traces Bitcoin funds for an address or transaction ID, mapping counterparties up to 3 hops with BTC flows, peel chains, consolidation patterns, and exchange-like volume.

## Facts

- Endpoint: GET https://agent-data.centorprat.workers.dev/crypto/btc-trace?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-transaction-tracer-onchain-risk-checks-466ca1f9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-SioQIazV71wXHbr6XKB-

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-transaction-tracer-onchain-risk-checks-466ca1f9
```

Example prompt: Can you trace the Bitcoin funds flowing through address 1A1zP1eP5QGefi2DMPTfTL5SLmv7Divf Nn up to 3 hops and tell me the main counterparties, any peel chain or consolidation patterns, and whether any of them look exchange-like?

## When to prefer this

Choose this endpoint when you need to trace Bitcoin fund flows across multiple hops with pattern detection (peel chains, consolidation, exchange-like volume) for AML, compliance, or fraud investigation purposes. It is specifically suited for Bitcoin (not other blockchains) and provides structured counterparty mapping rather than raw blockchain data. Prefer it over generic blockchain explorers when you need agent-consumable, structured risk signals.

## Known failure modes

- Invalid Bitcoin address format returns an error or empty result
- Invalid or unconfirmed txid may return no data
- Requesting more than 3 hops is not supported
- Rate limiting or payment failure if x402 payment is not processed
- Sparse on-chain history for new addresses may yield limited counterparty data

## How this service works

Pay-per-call data and tools for AI agents, $0.002-0.01 per call in USDC via x402 (Base, Polygon or Solana), no account or API key; MAX tiers ($0.05-0.25) run deeper jobs. Agent toolkit: web search, search + read top pages, any page as clean markdown with a prompt-injection check, which-x402-API-to-call recommender, seller check. Data: Google Maps places with contacts, YouTube video data and transcripts, job listings (Indeed, LinkedIn, 13 boards), Google Ads Transparency, TikTok comments, Pinterest, Airbnb, Redfin, AliExpress, app stores, live sports, website and SEO checks, Shopify store tech stacks, and onchain token / address risk checks.

## Output

Returns a graph of counterparties up to the requested number of hops (1-3), including BTC flow amounts between addresses, detected behavioral patterns (peel chains, consolidation, exchange-like volume), and for a txid: the full set of inputs, outputs, and next-hop addresses.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "hops": {
       "type": "string",
       "description": "1-3 (default 1)"
      },
      "txid": {
       "type": "string",
       "description": "Or a transaction id"
      },
      "address": {
       "type": "string",
       "description": "Bitcoin address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "bc1qa5wkgaew2dkv56kfvj49j0av5nml45x9ek9hz6",
  "type": "address",
  "found": true,
  "txCount": 194,
  "balanceBtc": 69370.18,
  "topSenders": [
   {
    "address": "bc1qcza6s6ew2kaxe9hdyrqqeuadc3za7fva5yjcnf",
    "valueBtc": 0.00006939
   }
  ],
  "txsAnalyzed": 25,
  "topRecipients": [],
  "uniqueSenders": 18,
  "uniqueRecipients": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-address-transaction-tracer-onchain-risk-checks-466ca1f9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data.centorprat.workers.dev](https://www.zero.xyz/host/agent-data.centorprat.workers.dev/llms.txt)