# ChainAnalyzer Wallet Clustering & Entity Resolution

> ChainAnalyzer Wallet Clustering & 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-14).

Clusters a blockchain wallet address with related addresses using common-input heuristics and Neo4j graph analysis, returning entity tags and known-entity attribution.

## Facts

- Endpoint: GET https://chain-analyzer.com/api/v1/x402/wallet/:address/cluster
- Price: $2.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainanalyzer-wallet-clustering-entity-resolution-298dfffb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_apbDDNrA5o1crC49-CcwR

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-clustering-entity-resolution-298dfffb
```

Example prompt: Can you cluster the wallet 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE and tell me what other addresses are controlled by the same entity, along with any known-entity tags like exchange or darknet market labels?

## When to prefer this

Use this endpoint when you need to identify ownership clusters and entity attribution for a specific blockchain address using graph-based heuristics. Prefer this over simple address lookups when you need to understand which wallets are co-controlled by the same entity. Best for investigations requiring wallet de-anonymization, exchange identification, or beneficial ownership mapping rather than transaction-level fund-flow tracing.

## Known failure modes

- Invalid or malformed wallet address returns 400 error
- Address with no transaction history returns empty cluster
- Unsupported blockchain network returns 422 or empty result
- Payment failure via x402 protocol returns 402 Payment Required
- Rate limiting or quota exceeded returns 429
- Graph database timeout for heavily-connected addresses may return partial results

## How this service works

Wallet clustering and entity resolution via Neo4j graph analysis. Returns related addresses, common-input heuristic clusters, and known-entity tags.

## Output

Returns a list of related wallet addresses grouped into ownership clusters via common-input heuristics, along with known-entity tags (e.g. exchange, mixer, darknet market) derived from Neo4j graph traversal and entity attribution data.

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainanalyzer-wallet-clustering-entity-resolution-298dfffb/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)