# HALOWERK kettenwerk Token Resolver

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

Resolves a token symbol, contract address, or price-directory ID to canonical token metadata across major EVM chains

## Facts

- Endpoint: POST https://kette.netzhandwerker.de/token/resolve
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-kettenwerk-token-resolver-e972dbc0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F0nkM5qXvYFpymLy2w6ki

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-resolver-e972dbc0 -d '<json body>'
```

Example prompt: What's the contract address for USDC on Base? Search across all chains if needed.

## When to prefer this

Use this endpoint when you need to resolve a human-readable token symbol (like 'USDC'), a raw contract address, or a price-directory identifier (like 'coingecko:usd-coin') into canonical token metadata across major EVM chains. Prefer this over general web search when you need authoritative on-chain contract addresses rather than approximate or potentially stale information. It is particularly useful in DeFi agent workflows where exact contract addresses are required before executing swaps, transfers, or contract calls.

## Known failure modes

- Token symbol is ambiguous and matches multiple tokens — endpoint may return multiple results or require disambiguation
- Contract address not found on any supported chain — returns empty or not-found response
- Unsupported chain specified — rejected by enum validation
- Query string exceeds 100 character limit — returns validation error
- Token exists but is not indexed in the price directory — coingecko: ID lookup may fail

## How this service works

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

## Output

Returns canonical token metadata for the matched token including name, symbol, contract address(es), and chain information for the queried network(s). When no chain filter is specified, results span all six supported chains (Ethereum, Base, Arbitrum, Optimism, Polygon, BSC).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "ethereum",
    "base",
    "arbitrum",
    "optimism",
    "polygon",
    "bsc"
   ],
   "type": "string",
   "description": "Restrict the answer to one chain. Omit to search all six."
  },
  "query": {
   "type": "string",
   "maxLength": 100,
   "minLength": 1,
   "description": "Token symbol (\"USDC\"), contract address (\"0x…\") or price-directory id (\"coingecko:usd-coin\")."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-kettenwerk-token-resolver-e972dbc0/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)