{"uid":"cap_207I_xjHRH9xFJO3z3UX7","slug":"fiatdock-erc-20-token-metadata-a50d1837","name":"FiatDock ERC-20 Token Metadata","description":"ERC-20 token metadata on Base — name, symbol, decimals, total supply. Pay-per-call via x402.","url":"https://fiatdock.com/v1/chain/token-metadata","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"token":{"type":"string","description":"An ERC-20 contract address (0x…) on Base"}}},"responseSchema":{"type":"json","example":{"asOf":"2026-07-30T00:00:00.000Z","name":"USD Coin","symbol":"USDC","network":"base","contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","decimals":6,"totalSupply":"4200000000","totalSupplyAtomic":"4200000000000000"}},"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_2nW-g8J9io0l6cGqOb_is","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 name, symbol, decimals, and total supply for any ERC-20 token contract on Base","exampleAgentPrompt":"What's the name, symbol, decimals, and total supply of the ERC-20 token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?","exampleUseCases":[{"title":"Identify unknown Base token contract","prompt":"I have a contract address on Base — 0x4200000000000000000000000000000000000006 — can you tell me what token this is, its symbol, and how many decimals it uses?"},{"title":"Build token display for DeFi dashboard","prompt":"For my DeFi dashboard I need the full metadata for USDC on Base: official name, symbol, decimals, and current total supply — the contract is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."},{"title":"Validate token decimals before swap","prompt":"Before I execute this swap, can you confirm how many decimals the token at 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb on Base uses, and what its full name and symbol are?"}],"resultDescription":"A JSON object containing the token's official name, ticker symbol, decimal precision, total supply as a formatted number, total supply in atomic units, the contract address, network identifier (base), and a timestamp of when the data was fetched.","failureModes":["Invalid or non-ERC-20 contract address returns an error — the address may be an EOA or non-token contract","Contract not deployed on Base returns a not-found or zero-data response","Malformed contract address (wrong length, bad checksum) returns a validation error","Payment failure via x402 (insufficient USDC) results in a 402 Payment Required response","Network congestion may cause slightly stale totalSupply if chain RPC is delayed"],"whenToPreferThis":"Use this endpoint when you need authoritative on-chain token metadata (name, symbol, decimals, total supply) for any ERC-20 on Base without maintaining your own RPC node. Prefer it over token price/safety endpoints when you only need structural metadata, not market data or risk signals. It is ideal for normalizing raw token amounts (using decimals), labeling tokens in a UI, or verifying a contract's identity before executing a transaction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:40:29.165Z","isFirstParty":false}