{"uid":"cap_wSFYBZIva_YFDIuJe8FWY","slug":"halowerk-kettenwerk-token-resolver-528c2f54","name":"HALOWERK kettenwerk Token Resolver","description":"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","url":"https://kette.halowerk.com/token/resolve?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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\")."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Qi5CVGBUavj8SMGMxdyr6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Canonical contract lookup before a swap","prompt":"Before I sign this swap, tell me which contract is the real USDC on Base — I want the canonical address, decimals, and whether the source is verified."},{"title":"Detecting impersonator tokens","prompt":"Search for every contract on Ethereum that carries the symbol USDT and show me which ones are canonical and which might be fakes or clones."},{"title":"Cross-chain token deployment audit","prompt":"I have the CoinGecko ID coingecko:usd-coin — can you resolve it to all its on-chain deployments and tell me each chain, contract address, and canonical status?"}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T18:31:27.584Z","isFirstParty":false,"canonicalSlug":"halowerk-kettenwerk-token-resolver-528c2f54"}