# agentsapi.top On-Chain Address Label Lookup

> agentsapi.top On-Chain Address Label Lookup is a paid API for AI agents from agentsapi.top, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Returns a curated human-readable identity label for a given Base blockchain address from a dataset of 100k+ named entities.

## Facts

- Endpoint: GET https://agentsapi.top/v1/label/:address?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentsapi-top-on-chain-address-label-lookup-4181b350
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sgGyNKm24Yr8gGU4-hHbC

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 agentsapi-top-on-chain-address-label-lookup-4181b350
```

Example prompt: Can you tell me what entity or organization is associated with the Base address 0x4200000000000000000000000000000000000006? I want to know if it's a known protocol, exchange, or named wallet.

## When to prefer this

Choose this endpoint when you need to quickly resolve a Base blockchain address to a known human-readable entity label without running complex on-chain analytics. It is ideal for enriching transaction data, annotating dashboards, or performing counterparty due diligence on Base. Prefer it over manual EDGAR or block explorer lookups when you need fast, pay-per-call resolution with a large pre-curated label set specifically tuned for the Base network.

## Known failure modes

- Address not found in label dataset — returns null or empty label
- Invalid address format — returns 400 or error response
- Payment failure via x402 — call rejected if USDC payment not processed
- Rate limiting or quota exceeded — returns 429 error
- Network or upstream service unavailability — returns 5xx error

## How this service works

Address tag lookup on Base: 104,209 entries from the open eth-labels dataset, mostly category tags (79.8% generic such as token-contract/stablecoin/burn, 18.7% exchange) rather than named entities. Unknown addresses return label:null and are still charged per call; measured hit rate on real inbound requests was 37.5% of unique addresses. Pay per call with USDC via x402.

## Output

Returns a human-readable identity label (e.g. organization name, protocol name, exchange name) associated with the queried Base blockchain address, drawn from a curated dataset of 100,000+ named entities. If no label exists, may return an empty or null result.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "address"
   ],
   "properties": {
    "address": {
     "type": "string",
     "format": "evm-address"
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentsapi-top-on-chain-address-label-lookup-4181b350/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentsapi.top](https://www.zero.xyz/host/agentsapi.top/llms.txt)