{"uid":"cap_H4uJ4MQgZjHowAx8GAmej","slug":"ethereum-token-metadata-lookup-ad510f3b","name":"Ethereum Token Metadata Lookup","description":"High-speed API suite for AI processing, web scraping, and smart data utilities across 57+ blockchain networks. Pay-per-call via x402.","url":"https://synapse-api-brown.vercel.app/api/ethereum/token/metadata","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"contractAddress":{"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TKoHnY9WwD1P2yc9omikG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns metadata (name, symbol, decimals, etc.) for an ERC-20 or other token contract on the Ethereum network given a contract address.","exampleAgentPrompt":"What's the name, symbol, and number of decimals for the Ethereum token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?","exampleUseCases":[{"title":"Identify unknown token in wallet","prompt":"I see a token at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 in my wallet — can you tell me what it's called and what its symbol and decimals are?"},{"title":"Validate contract before DeFi trade","prompt":"Before I swap, can you look up the metadata for the Ethereum contract 0x6B175474E89094C44Da98b954EedeAC495271d0F so I can confirm it's actually DAI and check the decimals?"},{"title":"Enrich token list with on-chain metadata","prompt":"I have this Ethereum contract address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 — fetch its token name, symbol, and decimals so I can add it to my portfolio tracker."}],"resultDescription":"Returns on-chain token metadata for the given Ethereum contract address, typically including the token name (e.g. 'USD Coin'), ticker symbol (e.g. 'USDC'), decimal precision (e.g. 6), and potentially additional fields like total supply or token standard.","failureModes":["Invalid or malformed contract address returns an error response","Contract address exists but is not a token contract (e.g. a plain wallet or non-ERC-20 contract) may return empty or error","Network timeout or RPC node issues may cause delayed or failed responses","Non-Ethereum contract addresses (e.g. from other chains) will not be resolved by this endpoint"],"whenToPreferThis":"Use this endpoint when you need to resolve an Ethereum mainnet contract address to its human-readable token metadata (name, symbol, decimals). Prefer this over generic blockchain explorers when you need a pay-per-call, programmatic, agent-friendly API response rather than a web page. Suitable for enriching wallet data, validating tokens before transactions, or building token lists.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:06:49.097Z","isFirstParty":false}