# USDC Counterparty Graph on Base

> USDC Counterparty Graph on Base is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Maps the on-chain USDC send/receive counterparty network for a Base address over N days, with up to 2 hops, returning labeled nodes and weighted edges for AML, sybil, and due diligence analysis.

## Facts

- Endpoint: GET https://api.x402node.dev/wallet/counterparty-graph
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-x402node-dev-5a67f7e4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7_zXx07DopFrHtgN0aWvi

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 api-x402node-dev-5a67f7e4
```

Example prompt: Can you pull the USDC counterparty graph for Base address 0xAbc123...def over the last 30 days, expanding two hops so I can see indirect links and flag any sanctioned or mixer-connected wallets?

## When to prefer this

Use this endpoint when you need on-chain USDC relationship mapping specifically on Base L2, especially for AML screening, due diligence, sybil cluster detection, or source-of-funds tracing. Prefer this over generic block explorers when you need structured graph output with risk labels and weighted edge data ready for agent consumption.

## Known failure modes

- Invalid or malformed Base address returns an error
- Lookback window too large may result in timeout or truncated results
- Address with no USDC activity returns an empty graph
- Payment failure (x402) results in 402 response and no data
- Hop 2 expansion on highly active addresses may be slow or rate-limited

## How this service works

USDC counterparty graph on Base: POST an address, maps who it sends/receives USDC to/from over N days (hop 1), optionally expands the top counterparties one more hop (hop 2) to reveal clusters and indirect links. Returns labeled nodes (CEX, DEX, bridge, sanctioned/mixer/scam) and weighted edges (tx count, USDC volume). For AI agent due diligence, AML graph analysis, sybil/cluster detection and source-of-funds mapping. Not financial advice.

## Output

A graph object with labeled nodes (tagged as CEX, DEX, bridge, sanctioned, mixer, scam, or unlabeled) and weighted directed edges representing USDC flows (transaction count and total USDC volume) between the queried address and its counterparties up to 2 hops away, enabling cluster detection and source-of-funds tracing.

## Example request

```json
{
 "days": 30,
 "hops": 2,
 "address": "0x1234567890123456789012345678901234567890"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "days": {
       "type": "string",
       "description": "Days (optional)"
      },
      "hops": {
       "type": "string",
       "description": "Hops (optional)"
      },
      "address": {
       "type": "string",
       "description": "EVM/chain address (required)"
      },
      "toAddress": {
       "type": "string",
       "description": "ToAddress (optional)"
      },
      "fromAddress": {
       "type": "string",
       "description": "FromAddress (optional)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-x402node-dev-5a67f7e4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)