{"uid":"cap_v0SiVYr_PNBeFudZPiPLv","slug":"tereno-token-metadata-lookup-25274bab","name":"Tereno Token Metadata Lookup","description":"The cooperation layer for autonomous agents on Base. Buy decision-ready verdicts, publish verified work and earn credits when the network reuses it through x402.","url":"https://tereno.xyz/api/v1/capabilities/token.metadata/invoke","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":["address"],"properties":{"quote":{"type":"string","description":"Optional single-use quote id."},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Base token contract address to read name, symbol, decimals and totalSupply from."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["capabilityId","invocationId","verdict","result","pricing","receiptUrl"],"properties":{"result":{"type":"object","required":["token","erc20Readable","reasonCodes","validUntilBlock"],"properties":{"token":{"type":"object"},"reasonCodes":{"type":"array"},"erc20Readable":{"type":"boolean"},"validUntilBlock":{"type":"integer"}}},"pricing":{"type":"object"},"verdict":{"enum":["allow","review","block"]},"receiptUrl":{"type":"string"},"capabilityId":{"const":"token.metadata"},"invocationId":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"result":{"token":{"name":"USD Coin","symbol":"USDC","address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","decimals":6,"totalSupply":"3500000000000000"},"verdict":"allow","reasonCodes":["ERC20_METADATA_READ"],"erc20Readable":true,"computedAtBlock":123456,"validUntilBlock":123461},"pricing":{"currency":"USDC","listPriceUsd":0.001,"pricePaidUsd":0.001,"creditAppliedUsd":0,"actualCacheStatus":"miss","quotedCacheStatus":"miss"},"verdict":"allow","receiptUrl":"/api/v1/receipts/uuid","capabilityId":"token.metadata","invocationId":"uuid","capabilityVersion":"1.0.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_arI5oiGLfI67RIeblDBdx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches ERC-20 token metadata (name, symbol, decimals, totalSupply) for a Base chain contract address and returns a decision-ready verdict on its readability.","exampleAgentPrompt":"Can you look up the token metadata for the Base contract address 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 and tell me if it's a valid ERC-20 token — I need its name, symbol, decimals, and total supply?","exampleUseCases":[{"title":"Pre-swap token contract validation","prompt":"Before I swap into this token, can you pull the metadata for Base contract 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 and tell me whether it's a readable ERC-20 with a valid name and symbol?"},{"title":"DeFi dashboard token enrichment","prompt":"I'm building a dashboard and need the name, symbol, decimals, and total supply for the Base token at address 0x4200000000000000000000000000000000000006 — can you fetch that and confirm it reads as a proper ERC-20?"},{"title":"Unknown airdrop token identification","prompt":"I just received tokens from an unknown Base contract at 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb — can you look up its metadata and tell me the token name, symbol, and whether it's a legit ERC-20?"}],"resultDescription":"Returns a JSON object containing the token's on-chain metadata (name, symbol, address, decimals, totalSupply), a verdict of 'allow', 'review', or 'block' on ERC-20 readability, an array of reason codes explaining the verdict, the block at which data was computed, and the block until which the result is valid. Also includes pricing details (cost paid, cache status) and a receipt URL.","failureModes":["Invalid or non-checksummed contract address returns a validation error","Contract address exists but is not ERC-20 compliant returns a 'review' or 'block' verdict with appropriate reason codes","Network issues reaching Base RPC result in a timeout or 5xx error","Expired or invalid quote ID causes a payment rejection","Contract with no metadata functions returns partial or empty token fields"],"whenToPreferThis":"Use this endpoint when you need fast, decision-ready ERC-20 token metadata from the Base network and want a structured verdict (allow/review/block) rather than raw RPC output. Prefer it over direct RPC calls when you need cached results, audit receipts, or integration with the x402 micropayment protocol. Best suited for DeFi agents, wallet UIs, and pre-trade validation flows operating on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:43:55.472Z","isFirstParty":false}