{"uid":"cap_1Q7Jt_B15IJLnSJrb-RMn","slug":"routheus-token-metadata-api-d0daf534","name":"Routheus Token Metadata API","description":"Routheus: live DEX token prices and best-route swap quotes from a real-time pool-state engine, executable routes with calldata (Permit2), simulation-verified outputs, token metadata, search and pool data on 13+ EVM chains. Pay per call in USDC via x402 — no API keys, no subscription.","url":"https://routheus.xyz/%7Bchain%7D/api/tokens/metadata?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["token"],"properties":{"token":{"type":"string","description":"Token address (0x…)"}}},"responseSchema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"data":{"type":"object","properties":{"name":{"type":"string"},"token":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer"},"balance_slot":{"type":"object","properties":{"slot_type":{"type":"string"},"slot_number":{"type":"integer"}},"description":"Storage slot info for eth_call balance overrides"}}},"error":{"type":"string","description":"Set for unknown tokens (never charged)"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vrDTZfyZXcPbXSxz0-tDc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches on-chain token metadata (name, symbol, decimals, storage slot) for a given EVM token address on a specified chain","exampleAgentPrompt":"Look up the token metadata for 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I need the name, symbol, and decimals.","exampleUseCases":[{"title":"Validate token before swap","prompt":"Before I execute a swap, can you pull the metadata for 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum so I can confirm it's DAI with 18 decimals?"},{"title":"Display token info in wallet UI","prompt":"I'm building a portfolio tracker — fetch the name, symbol, and decimals for 0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599 on Ethereum so I can label it correctly."},{"title":"Retrieve storage slot for simulation","prompt":"Get the full metadata including balance slot info for 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I need the slot number to run an eth_call balance override in my simulation."}],"resultDescription":"Returns a JSON object with ok=true and a data object containing the token's name, symbol, decimals, contract address, and balance_slot details (slot_type and slot_number for eth_call overrides). If the token is unknown, returns ok=false with an error string and no charge is applied.","failureModes":["Unknown or unindexed token address returns ok=false with an error field (no charge applied)","Invalid chain identifier in path returns an error response","Malformed token address (not a valid 0x hex address) returns a validation error","Chain not among the 13+ supported EVM chains returns an error","Network or upstream pool-state engine timeout may result in a transient 5xx error"],"whenToPreferThis":"Choose this endpoint when you need authoritative on-chain token metadata (name, symbol, decimals, storage slot) for EVM tokens without requiring an API key or subscription — especially useful in DeFi automation pipelines, swap routing, and simulation workflows where balance slot data is needed for eth_call overrides. Prefer over generic blockchain RPC calls when you want structured, pre-validated metadata with pay-per-call USDC pricing via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:39:07.310Z","isFirstParty":false,"canonicalSlug":"routheus-token-metadata-api-d0daf534"}