# HALOWERK kettenwerk Token Report

> HALOWERK kettenwerk Token Report is a paid API for AI agents from kette.netzhandwerker.de, paid per call via x402, $0.014/call, status unknown (last checked 2026-09-14).

Generates a comprehensive on-chain report for a given ERC-20 token contract, including optional upgrade history, across major EVM chains.

## Facts

- Endpoint: POST https://kette.netzhandwerker.de/token/report
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-kettenwerk-token-report-996d617d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8BpSOfrnkQccGBGYFjKof

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 halowerk-kettenwerk-token-report-996d617d -d '<json body>'
```

Example prompt: Can you run a full token report on the contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I want the complete analysis including upgrade history.

## When to prefer this

Use this endpoint when you need structured on-chain analysis of an ERC-20 token contract on a major EVM chain, especially when upgrade/proxy history is relevant for due diligence. Prefer the 'schnell' depth for fast lookups where upgrade history is not needed. Choose this over generic block explorers when you need a machine-readable, structured report rather than a human-readable UI.

## Known failure modes

- Invalid token address format (must match ^0x[0-9a-fA-F]{40}$) returns a validation error
- Unsupported chain name returns an enum validation error
- Contract address does not exist on the specified chain returns empty or error response
- Payment failure via x402 protocol prevents access to the endpoint
- Log scan timeout or RPC failure may cause 'voll' mode to partially fail or fall back

## How this service works

HALOWERK kettenwerk — bezahlte Endpunkte nach x402. Preise in USDC auf Base Mainnet.

## Output

Returns a structured token report for the specified contract address on the given EVM chain. In 'voll' (full) mode this includes upgrade/proxy history gathered via log scan; in 'schnell' (fast) mode it skips the log scan. The report contains on-chain token metadata, contract details, and where applicable a history of contract upgrades.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "ethereum",
    "base",
    "arbitrum",
    "optimism",
    "polygon",
    "bsc"
   ],
   "type": "string",
   "description": "Chain the token lives on."
  },
  "depth": {
   "enum": [
    "schnell",
    "voll"
   ],
   "type": "string",
   "default": "voll",
   "description": "\"schnell\" skips the upgrade history, which needs a log scan; \"voll\" runs everything available."
  },
  "token": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "Token contract address."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-kettenwerk-token-report-996d617d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kette.netzhandwerker.de](https://www.zero.xyz/host/kette.netzhandwerker.de/llms.txt)