# btcnode.uk Bitcoin Address Taint/Ancestry Analysis

> btcnode.uk Bitcoin Address Taint/Ancestry Analysis is a paid API for AI agents from btcnode.uk, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Walks a Bitcoin address's transaction chain up to 5 hops to compute a risk score (0-100), detecting mixing patterns like Wasabi CoinJoin and multi-input mixing

## Facts

- Endpoint: GET https://btcnode.uk/api/agent/taint/:address
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/btcnode-uk-bitcoin-address-taint-ancestry-analysis-a0fba819
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bZ8KOlFT1szOB0uiFqL66

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 btcnode-uk-bitcoin-address-taint-ancestry-analysis-a0fba819
```

Example prompt: Can you check the taint and risk score for the Bitcoin address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh — I want to know if it's been through any CoinJoin or mixing in the last 5 hops?

## When to prefer this

Use this endpoint when you need a quick, scored risk assessment of a Bitcoin address's coin ancestry — especially to detect mixing or CoinJoin usage. Prefer this over generic blockchain explorers when compliance, AML screening, or fund provenance verification is the goal. Best suited for single-address taint checks with up to 5-hop depth.

## Known failure modes

- Invalid or malformed Bitcoin address returns an error
- Address not found on chain may return empty or null results
- Deeply nested chains beyond 5 hops are not analyzed
- Network timeout if Bitcoin node is under load
- Rate limiting or payment failure if x402 micropayment not processed

## How this service works

Coin Taint/Ancestry — walk tx chain up to 5 hops, risk score 0-100. Detects Wasabi CoinJoin, multi-input mixing.

## Output

Returns a risk score between 0 and 100 for the given Bitcoin address, along with taint/ancestry data tracing up to 5 hops back through the transaction chain. Flags the presence of Wasabi CoinJoin transactions or multi-input mixing patterns detected along the coin's history.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "pathParams": {
   "address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
  },
  "queryParams": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/btcnode-uk-bitcoin-address-taint-ancestry-analysis-a0fba819/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from btcnode.uk](https://www.zero.xyz/host/btcnode.uk/llms.txt)