{"uid":"cap_cUrhfakhEbArb5lCblQwb","slug":"x-data-gateway-token-metadata-lookup-base-2b1c656b","name":"X Data Gateway — Token Metadata Lookup (Base)","description":"Metadata for a token contract (prefers Base). name/symbol/priceUsd always refer to the *requested* address — not the other side of a DEX pair. Stables fall back to registry if Dex is rate-limited. e.g. GET /v1/token/meta?address=0x8335...USDC","url":"https://x-data-gateway.annushka1190.workers.dev/v1/token/meta","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":["address"],"properties":{"address":{"type":"string","description":"Token contract 0x..."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oFrjJNuRkpMelzkizHr8g","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches on-chain metadata for a Base network token contract address, including name, symbol, decimals, and related market data.","exampleAgentPrompt":"Can you look up the token metadata for the Base contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I want to know the name, symbol, and decimals?","exampleUseCases":[{"title":"Identify unknown airdrop token","prompt":"I just received some tokens at contract 0x4200000000000000000000000000000000000006 on Base — can you pull the metadata so I know what it is, its symbol and decimals?"},{"title":"DeFi app token validation","prompt":"Before I integrate this token into our app, can you fetch the on-chain metadata for Base contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 so I can confirm the name, symbol, and decimals are correct?"},{"title":"Portfolio tracker token enrichment","prompt":"I have a list of Base token addresses in my portfolio and I need the name and symbol for 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb — can you grab that metadata for me?"}],"resultDescription":"Returns a JSON object with token metadata for the given Base contract address, including fields such as token name, symbol, decimals, and potentially additional on-chain or market-related attributes. Response is wrapped in a 'data' key.","failureModes":["Invalid or malformed contract address returns an error","Contract address not found on Base network returns empty or error response","Non-Base chain addresses may return no results","Network or upstream provider outage causes timeout","Missing required 'address' query parameter returns validation error"],"whenToPreferThis":"Use this endpoint when you need to identify or enrich a specific Base network ERC-20 token by its contract address, especially when you want name, symbol, and decimals without needing full market pricing data. Prefer this over spot price endpoints when the primary goal is token identification rather than pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:45:17.969Z","isFirstParty":false}