# Obol Bitcoin Cash Address Cluster Lookup

> Obol Bitcoin Cash Address Cluster Lookup is a paid API for AI agents from obol.danieldutoit.net, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Returns the cluster of addresses associated with a given Bitcoin Cash address using verified on-chain blockchain data.

## Facts

- Endpoint: GET https://obol.danieldutoit.net/v1/bitcoin-cash/address-cluster
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/obol-bitcoin-cash-address-cluster-lookup-ee4f7980
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HfYxvz-Gskx2vhnZSp3vu

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 obol-bitcoin-cash-address-cluster-lookup-ee4f7980
```

Example prompt: Can you look up the address cluster for this Bitcoin Cash address — bitcoincash:qp3wjpa3tjlj042z2wv7hahsldgwhwy0rq9sywjpyy — and tell me which other addresses are grouped with it?

## When to prefer this

Choose this endpoint when you need verified, on-chain Bitcoin Cash address clustering data paid per-call via USDC micropayments on Base. Prefer it for forensic analysis, compliance checks, or wallet attribution on the Bitcoin Cash network specifically. It is distinct from generic blockchain explorers in that it provides clustering (ownership grouping) rather than simple transaction history, and uses a pay-per-use model suitable for agents with variable query volume.

## Known failure modes

- Invalid or malformed Bitcoin Cash address returns an error response
- Address not found in blockchain data returns empty or null cluster
- Payment failure via x402 protocol prevents data access
- Network timeout or service unavailability returns 5xx error
- Non-BCH address format (e.g. BTC or ETH address) may return error or empty result

## How this service works

Obol sells verified blockchain data over x402, settled in USDC on Base.

## Output

A JSON object containing the cluster of Bitcoin Cash addresses associated with the queried address, identifying addresses likely controlled by the same entity based on verified on-chain heuristics.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "address": "1BpEi6DfDAUFd7GtittLSdBeYJvcoaVggu",
  "cluster": null,
  "network": "bitcoin-cash",
  "coverage": {
   "match_type": "exact_address",
   "maximum_results": 1
  },
  "clustered": false,
  "disclaimer": "Heuristic public-chain clustering; a cluster is not proof of common ownership or identity."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/obol-bitcoin-cash-address-cluster-lookup-ee4f7980/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from obol.danieldutoit.net](https://www.zero.xyz/host/obol.danieldutoit.net/llms.txt)
