{"uid":"cap_Lj-xnXsURLKb8zhMFKUwQ","slug":"tokenvault-erc-20-token-metadata-on-base-373fc15f","name":"Tokenvault — ERC-20 Token Metadata on Base","description":"ERC-20 token metadata on Base, read live from the contract: name, symbol, decimals and total supply. Pass ?token=0x… (the token contract address). One eth_call set, no third-party API, no cache.","url":"https://oraclepost.higgsfield.app/api/premium/token","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":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["token"],"properties":{"token":{"type":"string","description":"ERC-20 contract address on Base, 0x-prefixed"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{}}}}},"responseSchema":null,"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_SZzniHm8KyFs1p2RMhBAP","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":"Returns live ERC-20 token metadata (name, symbol, decimals, total supply) from a contract on Base by making direct eth_call reads with no cache or third-party API.","exampleAgentPrompt":"Look up the token metadata for the contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I need the name, symbol, decimals, and total supply straight from the contract.","exampleUseCases":[{"title":"Identify unknown token contract","prompt":"I found this contract address 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA on Base — can you tell me what token it is, its symbol, and how many decimals it uses?"},{"title":"Verify token total supply for due diligence","prompt":"What is the live total supply of the token at 0x4200000000000000000000000000000000000006 on Base? I want the number read directly from the contract, not from a third-party index."},{"title":"Enrich DeFi dashboard with token details","prompt":"For each of these Base token addresses I'm tracking, pull the name, symbol, and decimals directly from the contract so I can label them correctly in my portfolio view — start with 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb."}],"resultDescription":"Returns the four standard ERC-20 metadata fields read live via eth_call from the Base chain: token name (string), symbol (string), decimals (uint8), and total supply (uint256). Data is real-time with no caching layer or third-party intermediary.","failureModes":["Invalid or non-ERC-20 contract address returns an error or empty/reverted call result","Contract on a network other than Base will not resolve correctly","Malformed 0x address format causes a validation or RPC error","Token contract that does not implement standard ERC-20 metadata functions (name/symbol/decimals) may return partial or no data","RPC node unavailability on Base causes a timeout or network error"],"whenToPreferThis":"Choose this endpoint when you need authoritative, uncached ERC-20 metadata (name, symbol, decimals, total supply) for a specific contract address on the Base network. It is ideal when freshness matters, when you cannot trust indexed or cached sources, or when verifying a contract's identity directly from the chain. Prefer it over generic block explorers or token registries when you need programmatic access to raw on-chain metadata without third-party data dependencies.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T06:45:44.433Z","isFirstParty":false}