# ChainAnalyzer Wallet Cluster & Entity Resolution

> ChainAnalyzer Wallet Cluster & Entity Resolution is a paid API for AI agents from chain-analyzer.com, paid per call via x402, $2.5/call, status unknown (last checked 2026-09-13).

Resolves a blockchain wallet address into its cluster group and entity tag (e.g. Tornado Cash) using Neo4j graph analysis, returning related addresses and a cluster ID.

## Facts

- Endpoint: GET https://chain-analyzer.com/x402/api/wallet/%7Baddress%7D/cluster
- Price: $2.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainanalyzer-wallet-cluster-entity-resolution-036229b6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DEZPnjOxA48vw5z9pN82-

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 chainanalyzer-wallet-cluster-entity-resolution-036229b6
```

Example prompt: Can you tell me what entity cluster the wallet 0x0000db5c8b030ae20308ac975898e09741e70000 belongs to and which other addresses are linked to it — I need to know if it's associated with Tornado Cash or any other known bad actor.

## When to prefer this

Choose this endpoint when you need to understand the full network of wallets controlled by or associated with a given address, identify whether a wallet belongs to a known entity (exchange, mixer, sanctioned group), or build a graph of related addresses for AML investigation. Prefer over a simple AML risk score when entity attribution and address clustering are the primary goals rather than a scalar risk rating.

## Known failure modes

- Address not found on supported chain — returns empty cluster or null entity_tag
- Unsupported chain for the given address format — may return error or no results
- Address too new or isolated with no graph links — returns cluster with no related_addresses
- Invalid address format — likely returns 400 or error in success field
- Rate limiting or payment failure via x402 — returns 402 Payment Required

## How this service works

Multi-chain blockchain AML and security intelligence platform for tokens, wallets, and stablecoins. Detect sanctions, money laundering, rug pulls, drainers, and stablecoin flow risks across 12 chains live (Bitcoin, Ethereum, Polygon, BNB Smart Chain, Base, Arbitrum, Optimism, Avalanche, Solana, Kaia, TRON, XRP). Stablecoin AML coverage for JPYC, USDT, USDC, PYUSD, FDUSD with FATF Travel Rule screening.

## Output

Returns a JSON object with the queried address, a boolean success flag, a cluster_id grouping co-controlled wallets, a human-readable entity_tag (e.g. 'Tornado Cash 0.1 ETH pool'), and an array of related_addresses identified through graph analysis as belonging to the same cluster.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "properties": {
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   }
  },
  "output": {
   "properties": {
    "example": {}
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "address": "0x0000db5c8b030ae20308ac975898e09741e70000",
  "success": true,
  "cluster_id": "cluster_8f3a2b",
  "entity_tag": "Tornado Cash 0.1 ETH pool",
  "related_addresses": [
   "0xabc1234567890abcdef1234567890abcdef12345",
   "0xdef1234567890abcdef1234567890abcdef67890"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainanalyzer-wallet-cluster-entity-resolution-036229b6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chain-analyzer.com](https://www.zero.xyz/host/chain-analyzer.com/llms.txt)