# TraceFast Ethereum Address Counterparties

> TraceFast Ethereum Address Counterparties is a paid API for AI agents from mpp.tracefast.xyz, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Returns the top counterparties (up to 100) of an Ethereum address ranked by transaction frequency, including counts from top-level calls, internal calls, and token transfers, with first/last block data.

## Facts

- Endpoint: GET https://mpp.tracefast.xyz/api/v1/chains/1/addresses/:address/counterparties
- 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/tracefast-ethereum-address-counterparties-700315bb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kP4zvRvzh68aQQrqEiRJ8

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 tracefast-ethereum-address-counterparties-700315bb
```

Example prompt: Show me the top 20 counterparties for Ethereum address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — I want to see which addresses it interacts with most, ranked by transaction count.

## When to prefer this

Use this endpoint when you need to map the on-chain social graph of an Ethereum address — specifically who it interacts with most and how often — across top-level calls, internal calls, and token transfers. It is ideal for due diligence, wallet profiling, DeFi relationship mapping, and compliance checks. Prefer this over raw transaction queries when you need pre-ranked, aggregated counterparty data rather than raw transaction lists.

## Known failure modes

- Invalid Ethereum address format returns an error
- Block number out of range or not yet mined returns an error
- Limit outside 1–100 range returns a validation error
- Address with no transaction history returns an empty list
- Payment not received or insufficient USDC results in 402 response
- Network congestion may cause timeouts on heavily active addresses

## How this service works

TraceFast knowledge graph: top counterparties of an Ethereum address, current or as of a block. Up to 100 addresses it interacts with most, ranked by successful transactions across top-level calls, internal calls and token transfers, each with transaction counts and first/last block. Query: block (historical cut, optional), limit (1..100). Docs: https://docs.tracefast.xyz/api/address-counterparties

## Output

A ranked list of up to 100 Ethereum addresses that the queried address has interacted with most, each entry including the counterparty address, aggregated transaction counts (top-level calls, internal calls, token transfers), and the first and last block numbers of their interactions.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "properties": {
    "method": {
     "type": "string",
     "enum": [
      "GET"
     ]
    },
    "pathParams": {
     "type": "object"
    }
   },
   "required": [
    "method"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tracefast-ethereum-address-counterparties-700315bb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mpp.tracefast.xyz](https://www.zero.xyz/host/mpp.tracefast.xyz/llms.txt)