# Etherscan Label Cloud Lookup

> Etherscan Label Cloud Lookup is a paid API for AI agents from api.chainmarket-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Retrieves Etherscan label cloud data, listing named entity labels (e.g. exchanges, protocols) with tag counts for Ethereum addresses and transactions

## Facts

- Endpoint: GET https://api.chainmarket-api.workers.dev/api/crypto/etherscan-label-cloud?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/etherscan-label-cloud-lookup-fed65153
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HYyujOYQD9znbkXfEwJzX

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 etherscan-label-cloud-lookup-fed65153
```

Example prompt: Search the Etherscan label cloud for entities matching 'coinbase' and return up to 20 results, showing how many addresses and transactions are tagged under each label.

## When to prefer this

Use this endpoint when you need to identify or enumerate named entity labels on Ethereum from Etherscan's label cloud — particularly for compliance research, address attribution, or discovering how many on-chain accounts/transactions are associated with a known organization. Prefer this over general blockchain explorers when you specifically need Etherscan's curated label taxonomy with tag count metadata.

## Known failure modes

- No labels match the provided name filter — returns empty labels array with matchCount 0
- Limit parameter out of range (must be 1–100) — may return error or default to 10
- Etherscan source unavailable — upstream fetch failure may return stale or error response
- Payment not processed — call is not charged on failure but result is not returned

## How this service works

Etherscan public address-label cloud: entity labels (e.g. Binance, 0x Protocol) with counts of tagged accounts, transactions and tokens, from the label page's embedded data. Filter by name or take the top labels by total. Does not list individual deposit wallets and does not separate CEX deposit tags from other labels.

## Output

Returns a list of matching Etherscan label entries, each with a name, slug, token tag count, account tag count, transaction tag count, and total tag count. Also includes the total number of labels in the cloud, the number of matches found, the source URL, and the timestamp of the last check.

## 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": [],
     "properties": {
      "name": {
       "type": "string",
       "description": "Optional case-insensitive part of a label name, e.g. binance"
      },
      "limit": {
       "type": "string",
       "description": "How many labels, 1 to 100 (default 10)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "labels": [
   {
    "name": "Binance",
    "slug": "binance",
    "tokenTags": 11,
    "totalTags": 5906718,
    "accountTags": 5906706,
    "transactionTags": 1
   },
   {
    "name": "Binance Charity",
    "slug": "binance-charity",
    "tokenTags": 0,
    "totalTags": 34,
    "accountTags": 34,
    "transactionTags": 0
   }
  ],
  "source": "https://etherscan.io/labelcloud",
  "checkedAt": "2026-10-23T09:35:57.512Z",
  "labelCount": 899,
  "matchCount": 2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/etherscan-label-cloud-lookup-fed65153/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.chainmarket-api.workers.dev](https://www.zero.xyz/host/api.chainmarket-api.workers.dev/llms.txt)