---
title: "Get Address Attribution Breakdown"
method: GET
path: "/api/v1/contract/{address}/attribution"
tags: ["Contract Intelligence"]
---

# Get Address Attribution Breakdown

`GET /api/v1/contract/{address}/attribution`

## Request

- Base URL: `https://cleartracedata.com` (the document declares no server; this is the origin it was published from)
- URL: `https://cleartracedata.com/api/v1/contract/{address}/attribution`
- Auth: none declared

**Public API: Returns the attribution breakdown for a single address.**

Pairs the cross-frontend attribution engine with the labeling pipeline: for
a given contract or wallet, this returns its per-chain volume split across
the four attribution vectors (proxy, calldata-suffix, fee-recipient,
aggregator), plus any human-readable label we've resolved.

Most useful for the **unlabeled** proxies and hidden frontends the engine
surfaces as `Unknown Proxy/Frontend (0x…)` — known, named protocol
contracts are keyed by name rather than address and may not resolve here.

## Path parameters

- `address` string, required

## Query parameters

- `chain` string: Filter to a single blockchain (ethereum, base, arbitrum, optimism).

## Response `200`

The cross-frontend attribution breakdown (4 vectors) for a single address, enriched with its auto-discovered label.

- AddressAttributionResponse
  - `address` string, required: The queried address (lower-cased).
  - `records` AddressAttributionRecord[], required: Per-chain attribution breakdown for this address, largest volume first.
    - `chain` string, required: The blockchain network.
    - `resolved_contract_name` string, required: The name the attribution engine assigned this address (often 'Unknown Proxy/Frontend (0x…)' for unlabeled contracts).
    - `label` string, nullable: Human-readable label from the auto-labeling pipeline, if one exists for this address+chain.
    - `entity_type` string, nullable: Classification from the labeling pipeline: token, router_or_proxy, contract, eoa, or delegated_eoa (EIP-7702).
    - `label_source` string, nullable: Where the label came from (nansen, arkham, etherscan, alchemy-*).
    - `confidence` string, nullable: Label confidence: high, medium, or low.
    - `total_volume_usd` number, required: Total USD volume attributed to this address on this chain. This is the sum of the four PARTITION columns (`aggregator_partner_volume_usd`, `aggregator_volume_usd`, `direct_volume_usd`, `proxy_volume_usd`) and deliberately EXCLUDES the overlay columns (`calldata_suffix_volume_usd`, `erc20_fee_volume_usd`), so summing every volume field double-counts.
    - `aggregator_partner_volume_usd` number, required: Volume explicitly tagged with an aggregator partner code.
    - `aggregator_volume_usd` number, required: Standard aggregator volume.
    - `calldata_suffix_volume_usd` number, required: Volume attributed via calldata suffix fingerprinting. OVERLAY, not a component of `total_volume_usd`: it re-describes dollars already counted in the partition columns, seen through a different attribution vector, and is deliberately excluded from the total. It may therefore EXCEED `total_volume_usd`, which is correct and not a bug. Never add it to a partition column: that double-counts.
    - `direct_volume_usd` number, required: Volume routed directly to DEX pools.
    - `erc20_fee_volume_usd` number, required: Volume attributed via secondary fee transfers: the fee-kickback vector credits the full trade amount to every intermediate transfer recipient in a transaction, so pools, vaults and multisigs accumulate large figures without being swap venues. OVERLAY, not a component of `total_volume_usd`: it re-describes dollars already counted in the partition columns, seen through a different attribution vector, and is deliberately excluded from the total. It may therefore EXCEED `total_volume_usd`, which is correct and not a bug. Never add it to a partition column: that double-counts.
    - `proxy_volume_usd` number, required: Volume routed through an unverified proxy before hitting DEX pools.
  - `total_volume_usd` number, required: Total attributed volume for this address summed across all returned chains.
  - `chains_found` integer, required: Number of chains on which this address has attributed volume.

---

[API](https://skmtc.dev/cleartracedata/apis/cleartrace-api.md) · [All operations](https://skmtc.dev/cleartracedata/apis/cleartrace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cleartracedata/apis/cleartrace-api/revisions/2073a5a38ab5?raw)