---
title: "Auto-Discovered Contract Labels"
method: GET
path: "/api/v1/labels"
tags: ["Contract Intelligence"]
---

# Auto-Discovered Contract Labels

`GET /api/v1/labels`

## 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/labels`
- Auth: none declared

**Public API: Returns contract labels discovered by the auto-labeling pipeline.**

Each sync, the highest-volume unattributed contracts are profiled through
local intelligence tables and Alchemy RPC (token metadata, bytecode size,
activity) to classify and, where possible, name them.

## Query parameters

- `chain` string: Filter by blockchain (ethereum, base, arbitrum, optimism).
- `limit` integer: Maximum number of labels to return.
- `offset` integer: Pagination offset.

## Response `200`

Labels for high-volume contracts resolved by the Alchemy-powered auto-labeling pipeline.

- ContractLabelsResponse
  - `labels` ContractLabel[], required: Contract labels discovered by the auto-labeling pipeline.
    - `address` string, required: The contract address.
    - `chain` string, required: The blockchain the contract was profiled on.
    - `label` string, nullable: Resolved human-readable name, when one was found.
    - `entity_type` string, required: Classification: token, router_or_proxy, contract, eoa, or delegated_eoa (EIP-7702).
    - `source` string, required: Where the label came from: nansen, arkham, etherscan, alchemy-token-metadata, or alchemy-heuristic.
    - `confidence` string, required: Label confidence: high, medium, or low.
    - `code_size` integer, nullable: Deployed bytecode size in bytes (0 for EOAs).
  - `total` integer, required: Total number of matching labels.
  - `limit` integer, required: The maximum number of labels returned.
  - `offset` integer, required: The offset used for pagination.

---

[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)