{"uid":"cap_mk6PFaZP2qGqoF78TiGmr","slug":"brainiac-token-metadata-api-a83b43e2","name":"BRAINIAC Token Metadata API","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/chain-data/token/metadata?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"blockNumber":{"type":"integer","maximum":9007199254740991,"minimum":0},"tokenAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}},"responseSchema":{"type":"json","example":{"name":"USD Coin","symbol":"USDC","chainId":8453,"sources":[{"url":"https://mainnet.base.org","source":"Base JSON-RPC","status":"OK","retrievedAt":"2026-11-07T12:08:59.919Z"}],"decimals":6,"blockNumber":"latest","limitations":["Metadata depends on the token contract implementing standard ERC-20 methods.","Name and symbol decoding supports standard ABI-encoded strings; non-standard encodings may return null.","Not all tokens implement all metadata methods."],"retrievedAt":"2026-11-07T12:08:59.919Z","totalSupply":"0x000000000000000000000000000000000000000000000000000f2dbd16d0a3f2","tokenAddress":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","totalSupplyDecimal":"4272414805500914"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VSD3LfBdgTveeDNmYLgKl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches on-chain metadata for a specific ERC-20 or other token contract at a given block number on a blockchain network","exampleAgentPrompt":"Can you look up the on-chain metadata — name, symbol, decimals — for the token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 at block number 19000000?","exampleUseCases":[{"title":"Identify unknown DeFi token","prompt":"I found this contract address 0x6B175474E89094C44Da98b954EedeAC495271d0F in my wallet transaction history — can you tell me what token it is, its symbol, and how many decimals it uses?"},{"title":"Historical token metadata audit","prompt":"Pull the on-chain metadata for the token at 0xdAC17F958D2ee523a2206206994597C13D831ec7 as it existed at block number 18500000 — I need the name and symbol recorded at that point in time."},{"title":"Enrich token address list with metadata","prompt":"I have a token contract address 0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599 and I need its full on-chain metadata including name, ticker symbol, and decimal precision so I can label it correctly in my records."}],"resultDescription":"A JSON object containing on-chain metadata for the specified token contract, including fields such as token name, symbol, decimals, and potentially other contract-level metadata. The data reflects the state at the specified block number, or at the latest block if none is provided.","failureModes":["Invalid token address format returns a validation error","Token address is not a recognized contract or has no metadata — empty or null response","Block number exceeds chain head or is out of range","Payment not received or insufficient USDC — 402 Payment Required response","Network or RPC timeout causing delayed or missing response"],"whenToPreferThis":"Use this endpoint when you need quick, cheap, pay-per-call access to ERC-20 or other token contract metadata without setting up an account or API key. It is ideal for agents that occasionally need token details on demand and want to pay micro-amounts per query. Prefer this over free RPC calls when you need a managed, reliable response without managing your own node infrastructure, and over larger data providers when cost per call matters and you do not need bulk data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-11T14:33:46.160Z","isFirstParty":false,"canonicalSlug":"brainiac-token-metadata-api-a83b43e2"}