# whale.hugen.tokyo Ethereum Address Label Lookup

> whale.hugen.tokyo Ethereum Address Label Lookup is a paid API for AI agents from whale.hugen.tokyo, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Resolves an Ethereum address to its entity label, name tag, and category from a database of 412K+ labeled on-chain identities

## Facts

- Endpoint: GET https://whale.hugen.tokyo/whale/lookup
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/whale-hugen-tokyo-514cde34
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KBZcn7zu-B9fNM6Xz50Ft

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 whale-hugen-tokyo-514cde34
```

Example prompt: Can you look up who owns or controls the Ethereum address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — I want to know its entity label, name tag, and what category it falls under?

## When to prefer this

Use this endpoint when you need to resolve an Ethereum address to a human-readable identity, entity label, or category — especially useful for blockchain analytics, due diligence on wallet addresses, or enriching transaction data with identity context. Prefer this over generic blockchain explorers when you specifically need structured label/category data accessible programmatically by an AI agent.

## Known failure modes

- Address not found in the 412K labeled set — returns empty or null result
- Invalid Ethereum address format — likely returns a 400 bad request
- Payment failure via x402 protocol — returns 402 Payment Required
- Rate limiting or quota exhaustion — returns 429 or equivalent
- Network timeout — returns 5xx error

## How this service works

Look up any Ethereum address — returns entity labels, name tags, and categories from 412K+ labeled addresses. AI agent API for on-chain identity resolution

## Output

Returns the entity label (e.g. 'Vitalik Buterin'), name tag, and category (e.g. 'individual', 'exchange', 'DeFi protocol') associated with the queried Ethereum address, sourced from a database of over 412,000 labeled addresses.

## Example request

```json
{
 "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}
```

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "required": [
    "method"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/whale-hugen-tokyo-514cde34/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from whale.hugen.tokyo](https://www.zero.xyz/host/whale.hugen.tokyo/llms.txt)