# HALOWERK kettenwerk Token Resolver

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

Resolves a token symbol, contract address, or price-directory ID to all matching on-chain contracts across up to six EVM chains, with canonical flag, verified source status, decimals, and market cap rank

## Facts

- Endpoint: POST https://kette.halowerk.com/token/resolve?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-kettenwerk-token-resolver-528c2f54
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wSFYBZIva_YFDIuJe8FWY

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-528c2f54 -d '<json body>'
```

Example prompt: Find all contracts that use the symbol USDC across Ethereum, Base, Arbitrum, Optimism, Polygon, and BNB Smart Chain — I need to know which one is canonical, plus each contract's name, decimals, verification status, and market cap rank.

## When to prefer this

Use this endpoint when you need to disambiguate a token symbol into concrete on-chain contract identities — especially before signing transactions, building allow-lists, or verifying that a contract matches the widely-understood asset. Prefer it over CoinGecko or CoinMarketCap APIs when you need the raw on-chain metadata (decimals, symbol, name read from contract) and verification status rather than price data. It covers Ethereum, Base, Arbitrum, Optimism, Polygon, and BNB Smart Chain in a single call with a canonical flag whose criterion is explicit.

## Known failure modes

- No contracts found for the given symbol or address — empty result array
- Invalid contract address format returns a validation error
- Unsupported chain value rejected by enum constraint
- Query too short or too long (minLength 1, maxLength 100) returns a schema error
- RPC timeouts on one or more chains may yield partial results
- Ambiguous symbol with hundreds of matches may be truncated

## How this service works

A symbol is not an identity. Dozens of contracts carry the symbol USDC and most of them are not the one anyone means. This endpoint returns all of them rather than silently picking one: every match carries its chain, contract, on-chain symbol, name and decimals read directly from the contract, whether its source is verified, its market cap rank when it is inside the top 250, and a canonical flag whose criterion is stated in the answer — a contract is canonical when the price directory lists it u

## Output

Returns an array of all matching token contracts across the queried chains, each entry containing the chain name, contract address, on-chain symbol, token name, decimals read directly from the contract, whether the source code is verified, an optional market cap rank (when the token ranks in the top 250), and a canonical boolean flag with a stated criterion (price directory listing).

## 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-528c2f54/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kette.halowerk.com](https://www.zero.xyz/host/kette.halowerk.com/llms.txt)