{"uid":"cap_hgsVynDRO416ZFt96BGXJ","slug":"aayat-ai-token-lookup-ccce7241","name":"Aayat AI Token Lookup","description":"Find the right contract for a token symbol or name across Ethereum, Base, Solana, BNB, Arbitrum, Polygon, Optimism and Avalanche, safely: each match is labelled verified (curated lists), likely-real, unverified or likely-impostor (copycat of the same symbol), with liquidity, 24h volume, price and age. Also accepts an address. ?query=PEPE&chain=ethereum","url":"https://aayatai.com/token/lookup?utm_source=zero.xyz","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":[],"properties":{"q":{"type":"string","maxLength":64,"minLength":2,"description":"Same as query."},"chain":{"enum":["all","base","solana","ethereum","bsc","arbitrum","polygon","optimism","avalanche"],"type":"string","default":"all","description":"Limit to one chain."},"limit":{"type":"integer","default":10,"maximum":30,"minimum":1,"description":"Most candidates to return."},"query":{"type":"string","maxLength":64,"minLength":2,"description":"Symbol (PEPE, $WIF), name (Pepe) or a contract address."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","best","perChain","candidates","ambiguous"],"properties":{"best":{"type":["object","null"],"description":"The most trustworthy match (the well-known token for the symbol, then trusted matches by liquidity and volume)."},"note":{"type":"string"},"query":{"type":"string"},"trust":{"type":"object","description":"Third-party text, cleaned: read trust.notice; removed = what we stripped."},"chosen":{"type":["object","null"],"description":"The pick: chain, address, name, symbol, status, liquidity and why it was chosen."},"sources":{"type":"array","items":{"type":"string"}},"perChain":{"type":"object","description":"Best verified or likely-real address on each chain."},"ambiguous":{"type":"boolean","description":"True when several different tokens could be meant: check the chain and address."},"checkedAt":{"type":"string"},"candidates":{"type":"array","description":"All matches, safest first: chain, address, name, symbol, status (verified, likely-real, unverified, likely-impostor), lists, liquidity, volume, price, first pool date, warnings."},"alternatives":{"type":"array","description":"Up to 3 other tokens with the same symbol or name (chain, address, status, liquidity)."},"ambiguousChains":{"type":"array","items":{"type":"string"},"description":"Chains with more than one verified or likely-real match."}}}}}}},"responseSchema":{"type":"json","example":{"best":{"name":"Pepe","chain":"ethereum","score":1188,"status":"verified","symbol":"PEPE","address":"0x6982508145454Ce325dDbE47a25d4ec3d2311933","onLists":["Uniswap default list"],"priceUsd":0.00000415,"warnings":[],"firstPoolAt":"2023-04-14T17:21:11.000Z","liquidityUsd":30819841,"volume24hUsd":1542213},"note":"","query":"PEPE","sources":["Uniswap default token list","Jupiter verified list","GeckoTerminal"],"perChain":{"ethereum":"0x6982508145454Ce325dDbE47a25d4ec3d2311933"},"ambiguous":false,"checkedAt":"2026-09-28T12:00:00.000Z","candidates":[],"ambiguousChains":[]}},"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_VVtJkx6SaEI92r_X8EMNN","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":"Resolves a token symbol, name, or contract address to verified contract addresses across 8 chains, with safety labels, liquidity, volume, price, and age data","exampleAgentPrompt":"Can you look up the real contract address for PEPE on Ethereum and tell me if it's verified, along with its current price, liquidity, and whether there are any impostor tokens using the same symbol?","exampleUseCases":[{"title":"Meme coin contract verification before trading","prompt":"I want to buy $WIF on Solana but I'm not sure which contract address is legitimate — can you find the verified contract for WIF and check if there are any impostor tokens I should watch out for?"},{"title":"Multi-chain token address resolution","prompt":"Find the official USDC contract addresses on Ethereum, Base, Arbitrum, and Polygon — I need to know which ones are verified and their current liquidity levels."},{"title":"Scam token detection for a wallet address","prompt":"Someone sent me a token at address 0xabc123... on BSC — can you check if this is a verified token, a likely impostor, or an unverified contract, and what its trading volume looks like?"}],"resultDescription":"Returns a JSON object with: the best match (most trustworthy candidate with chain, address, symbol, name, safety status, price in USD, liquidity in USD, 24h volume in USD, first pool date, and warnings), a per-chain map of best addresses, an array of all candidates sorted safest-first (each with status: verified/likely-real/unverified/likely-impostor), an ambiguous flag indicating multiple plausible matches, a list of chains with ambiguous matches, and the data sources used.","failureModes":["Token symbol not found on any chain — returns empty candidates array","Address provided is not a known contract — returns unverified or empty result","Chain filter too restrictive — no results on specified chain even if token exists elsewhere","Highly ambiguous symbol (e.g. TEST) — many unverified candidates returned with ambiguous:true","Rate limit or payment failure — HTTP 402 if payment not provided","Query too short (under 2 characters) — rejected by schema validation"],"whenToPreferThis":"Use this endpoint when an agent needs to safely resolve a token symbol or name to a contract address before executing a trade, displaying token info, or assessing risk. It is specifically valuable over a raw DEX or chain explorer query because it cross-references curated token lists (Uniswap default list, Jupiter verified list) and flags impostors — essential for meme coins and long-tail tokens where copycat contracts are common. Prefer this over generic price APIs when safety classification and multi-chain disambiguation are the primary concern.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:48:57.509Z","isFirstParty":false,"canonicalSlug":"aayat-ai-token-lookup-ccce7241"}