{"uid":"cap__htZYAei0w03EwpWlDOiG","slug":"tereno-token-metadata-1e89b4ef","name":"Tereno Token Metadata","description":"What token is this? Read a Base token's name, symbol, decimals and total supply in one cheap typed call, with block-level freshness and explicit limitations. Identity is shared across agents for 7 days while total supply is re-read on every call beyond the block window the answer was quoted for. Positive-sum by design: $0.03 cold, $0.02 when the token identity is already shared, $0.01 on a shared full answer — and the wallet that seeded it earns a share of every reuse.","url":"https://www.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":null,"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_QVWjYwHu5o40ROg3yvAnH","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":"Reads a Base network ERC-20 token's name, symbol, decimals, and total supply from a contract address in a single cached call.","exampleAgentPrompt":"What's the name, symbol, decimals, and total supply of the Base token at contract address 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA?","exampleUseCases":null,"resultDescription":"Returns a result object with a token sub-object containing name, symbol, decimals, and totalSupply; a boolean erc20Readable indicating whether the contract is a valid readable ERC-20; an array of reasonCodes explaining any limitations; and a validUntilBlock integer indicating block-level freshness of the cached data. Also includes pricing details, a verdict (allow/review/block), a receiptUrl, and an invocationId.","failureModes":["Invalid or non-checksummed address format returns a validation error","Contract address does not exist on Base returns erc20Readable: false with relevant reasonCodes","Contract exists but does not implement ERC-20 interface returns erc20Readable: false","Proxy or non-standard token may return incomplete metadata with reasonCodes explaining the gap","Stale cache near block boundary may return slightly outdated data until next block refresh","Payment failure or missing x402 payment header returns HTTP 402"],"whenToPreferThis":"Use this endpoint when you need fast, cheap token metadata (name, symbol, decimals, total supply) for a known Base contract address without making raw RPC calls. Ideal for agents enriching transaction data, validating token addresses before interaction, or displaying human-readable token info. Prefer over raw blockchain RPC when you want caching, structured output, and explicit freshness guarantees. Use sibling endpoints like Contract Interface Detector if you also need to confirm which ERC standard is implemented, or Contract Guard if you need safety/risk signals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:40:11.682Z","isFirstParty":false}