{"uid":"cap_bfokgiYX8lZ627v7nQjXF","slug":"token-metadata-lookup-crypto-microdata-for-agents-x402-960ed160","name":"Token Metadata Lookup – Crypto Microdata for Agents (x402)","description":"Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.","url":"https://kr-x402-mvp.kgy5612.workers.dev/api/chain/token-metadata?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"enum":["base","eth"],"type":"string","description":"base (default) or eth mainnet"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"description":"Address to inspect"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"kind":"ERC20","next":["/crypto/token-risk?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","/crypto/allowance?owner=&spender="],"safe":null,"chain":"base","flags":["upgradeable_proxy","has_owner","admin_can_change_logic"],"owner":"0x...","proxy":{"type":"ZEPPELINOS_LEGACY","admin":"0x4fc7850364958d97b4d3f5a08f79db2493f8ca44","beacon":null,"is_proxy":true,"implementation":"0x2ce6311ddae708829bc0784c967b7d77d19fd779"},"token":{"name":"USD Coin","symbol":"USDC","decimals":6,"total_supply":4100000000},"address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","summary":"ERC20 USDC behind ZEPPELINOS_LEGACY proxy, has owner","chain_id":8453,"checked_at":"2026-10-30T03:40:00Z","interfaces":{"erc165":false,"erc721":false,"erc1155":false},"is_contract":true,"native_balance":0,"code_size_bytes":1852,"owner_renounced":false}},"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_Dcm50OsFn909_mjnRGsJ0","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":"Returns on-chain metadata for an ERC20 or contract address on Base or Ethereum, including token details, proxy info, risk flags, and interface types, paid per-call via x402 USDC.","exampleAgentPrompt":"Can you pull the token metadata for the contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want to know the token name, symbol, decimals, whether it's behind a proxy, and any risk flags like upgradeability or owner control?","exampleUseCases":[{"title":"Pre-trade token safety check","prompt":"Before I swap into this token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, can you check whether it's an upgradeable proxy or has an owner who could rug it?"},{"title":"Identify unknown contract on Base","prompt":"I received tokens from 0x4200000000000000000000000000000000000006 on Base — can you tell me what token this is, its symbol, decimals, and whether it's a standard ERC20?"},{"title":"DeFi integration due diligence","prompt":"We're integrating a new ERC20 at address 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb on Base — check its proxy type, admin address, and any risk flags before we proceed."}],"resultDescription":"A JSON object containing: contract kind (e.g. ERC20), token name/symbol/decimals/total supply, proxy details (type, admin, implementation, beacon), risk flags array (e.g. upgradeable_proxy, has_owner, admin_can_change_logic), owner address and whether renounced, ERC165/721/1155 interface support booleans, native ETH balance, code size in bytes, chain and chain_id, timestamp, and suggested next endpoint paths for further investigation.","failureModes":["Invalid address format (not matching ^0x[0-9a-fA-F]{40}$) returns a 400 error","Address is an EOA (externally owned account), not a contract — is_contract will be false","Contract exists but is not a token — token fields may be null or absent","Unsupported chain value (anything other than 'base' or 'eth') returns an error","x402 payment failure (insufficient USDC balance or misconfigured wallet) blocks the call","Network timeout or RPC unavailability on the target chain"],"whenToPreferThis":"Use this endpoint when an AI agent needs to quickly classify and risk-assess a smart contract or ERC20 token address on Base or Ethereum mainnet without needing an API key. It is ideal for pre-trade safety checks, DeFi integration due diligence, identifying unknown tokens received in a wallet, or verifying proxy patterns before trusting a contract. Prefer it over block-explorer scraping or full node queries when you need structured, agent-ready JSON with risk flags and suggested follow-up endpoints, and when pay-per-call micro-billing via x402 USDC is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:19.362Z","isFirstParty":false,"canonicalSlug":"token-metadata-lookup-crypto-microdata-for-agents-x402-960ed160"}