{"uid":"cap_e-MyQLWi85xLPiIOFhzZB","slug":"fathom-api-erc-20-token-metadata-lookup-c1b72c96","name":"Fathom API - ERC-20 Token Metadata Lookup","description":"Returns ERC-20 metadata for a Base token, including address, symbol, name, and decimals.","url":"https://fathom-api.mioku-fathom.workers.dev/v1/metadata","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":["token"],"properties":{"chain":{"type":"string","const":"base","default":"base"},"token":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Base ERC-20 token address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["address","symbol","name","decimals"],"properties":{"name":{"type":"string"},"symbol":{"type":"string"},"address":{"type":"string"},"decimals":{"type":"number"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ufmUKn5Ee9L5ELKdNs3LX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ERC-20 token metadata (address, symbol, name, decimals) for a given Base network token contract address.","exampleAgentPrompt":"What are the name, symbol, and decimals for the Base ERC-20 token at address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the token's contract address, human-readable name (e.g. 'USD Coin'), ticker symbol (e.g. 'USDC'), and decimal precision (e.g. 6) for the specified Base ERC-20 token.","failureModes":["Invalid or malformed token address (not matching 0x + 40 hex chars) returns a validation error","Token address not found on Base network returns an empty or error response","Payment of 0.001 USDC not provided results in HTTP 402 Payment Required","Network or Cloudflare Worker downtime causes service unavailability"],"whenToPreferThis":"Use this endpoint when you need basic ERC-20 token metadata (name, symbol, decimals) for a known contract address on the Base network. Ideal for enriching token display information, validating token identity, or preparing data for DeFi operations. Prefer this over the sibling price endpoint when you only need token descriptive metadata rather than pricing or liquidity data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:33:10.346Z","isFirstParty":false}