{"uid":"cap_QgiOZP6rMuqpMLjw1c4vo","slug":"basefeed-erc-20-token-metadata-2042f375","name":"basefeed ERC-20 Token Metadata","description":"Batch ERC-20 metadata (2-10 addresses)","url":"https://api.basefeed.io/v1/meta/tokens","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["addresses"],"properties":{"chain":{"enum":["base","base-sepolia"],"type":"string","default":"base"},"addresses":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"count":2,"tokens":[]}},"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_RgdJJSG1-TLpKIgXE4u44","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 ERC-20 token metadata (name, symbol, decimals, etc.) for one or more token addresses on Base or Base Sepolia, paid per call in USDC via x402.","exampleAgentPrompt":"Can you look up the name, symbol, and decimals for these two Base token contracts: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 and 0x4200000000000000000000000000000000000006?","exampleUseCases":[{"title":"Identify unknown token by contract","prompt":"I found this contract address on Base — 0x940181a94A35A4569E4529A3CDfB74e38FD98631 — can you tell me what token it is, its symbol, and how many decimals it uses?"},{"title":"Enrich DeFi portfolio with token metadata","prompt":"I have a list of ERC-20 addresses in my Base wallet — 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 0x4200000000000000000000000000000000000006, and 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb — can you fetch the name and symbol for each so I can label them properly?"},{"title":"Validate token on Base Sepolia testnet","prompt":"On Base Sepolia testnet, can you pull the metadata for contract address 0x036CbD53842c5426634e7929541eC2318f3dCF7e so I can confirm it matches the token I deployed?"}],"resultDescription":"A JSON object with ok (boolean), count (integer number of tokens returned), and a tokens array containing metadata for each queried address — typically including name, symbol, decimals, and contract address for each ERC-20 token on the specified chain.","failureModes":["Invalid or malformed contract address returns error or empty token entry","Address not corresponding to an ERC-20 token returns empty or null metadata","Missing required 'addresses' query parameter returns validation error","Payment failure via x402 (insufficient USDC balance) returns 402 Payment Required","Unsupported chain value returns validation error","Rate limiting or node downtime may return 5xx errors"],"whenToPreferThis":"Choose this endpoint when you need on-chain ERC-20 token metadata (name, symbol, decimals) for specific contract addresses on Base mainnet or Base Sepolia, without needing a signup or API key. It is ideal for lightweight, pay-per-call lookups — particularly useful for agents enriching wallet data, validating tokens, or labeling DeFi positions. Prefer it over general-purpose blockchain RPC calls when you want a simple REST interface rather than raw JSON-RPC, and over other metadata APIs when you want to pay only for what you use via USDC on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:35:47.288Z","isFirstParty":false}