# Kette Wallet Counterparties Graph

> Kette Wallet Counterparties Graph is a paid API for AI agents from kette.halowerk.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Maps the counterparty addresses a wallet has interacted with on-chain, counts interaction edges, and labels each contract by type using curated or verified names — capped at depth-2 to avoid de-anonymisation.

## Facts

- Endpoint: POST https://kette.halowerk.com/wallet/counterparties
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kette-wallet-counterparties-graph-f34c8a12
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rUs6RLlvt5W3F5_AkzXXo

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 kette-wallet-counterparties-graph-f34c8a12 -d '<json body>'
```

Example prompt: Can you map out the counterparty graph for wallet 0xabc...123 on Ethereum — show me every contract it's interacted with, how many times, and what type of contract each one is?

## When to prefer this

Use this endpoint when you need to understand the on-chain relationship graph of a wallet — which contracts it interacted with, how often, and what those contracts do — without needing deeper recursive tracing. It is ideal for compliance checks, DeFi exposure analysis, and counterparty profiling where contract-level labeling (not person identification) is the goal. Prefer it over raw transaction queries when you need structured, labeled, aggregated edge data rather than raw tx lists.

## Known failure modes

- Invalid or unrecognized wallet address format returns an error
- Unsupported chain returns an error indicating which networks are available
- Wallet with no transaction history returns an empty counterparty list
- Rate limiting or RPC unavailability may cause partial or delayed results
- Very high-volume wallets may hit response size or time limits

## How this service works

Collects the addresses a wallet interacted with from its transactions and token transfers, counts the interactions per edge and names the type of each contract where it can be backed by a curated entry or a verified contract name. Depth is capped at two by design: anything deeper turns this into a tool for de-anonymisation, and that is not built here. Limits and the rule that matters: only contract designations and service types are reported. There is NO assignment to natural persons, no names, 

## Output

A graph of counterparty addresses the wallet has interacted with, with each edge annotated with an interaction count, the contract's type or service category, and where available a curated or verified contract name. Depth is capped at 2 hops. No natural person names or identity assignments are included — only contract designations and service types.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "depth": {
   "type": "integer",
   "default": 1,
   "maximum": 2,
   "minimum": 1,
   "description": "Graph depth. Two is the hard maximum by design."
  },
  "chains": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 4,
   "description": "Chains to query. Default: ethereum, base, arbitrum, optimism."
  },
  "wallet": {
   "type": "string",
   "description": "Wallet address, 0x followed by 40 hex characters."
  },
  "window": {
   "enum": [
    "7d",
    "30d",
    "90d",
    "all"
   ],
   "type": "string",
   "default": "30d"
  },
  "min_interactions": {
   "type": "integer",
   "default": 1,
   "minimum": 1,
   "description": "Only keep edges with at least this many interactions."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kette-wallet-counterparties-graph-f34c8a12/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kette.halowerk.com](https://www.zero.xyz/host/kette.halowerk.com/llms.txt)