# Aayat AI Token Lookup > Aayat AI Token Lookup is a paid API for AI agents from aayatai.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-02). Resolves a token symbol, name, or contract address to verified contract addresses across 8 chains, with safety labels, liquidity, volume, price, and age data ## Facts - Endpoint: GET https://aayatai.com/token/lookup?utm_source=zero.xyz - Price: $0.003/call - Payment: x402 - Status: unknown - Last checked: 2026-10-02 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/aayat-ai-token-lookup-ccce7241 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hgsVynDRO416ZFt96BGXJ Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability aayat-ai-token-lookup-ccce7241 ``` Example prompt: 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? ## When to prefer this 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. ## Known failure modes - 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 ## How this service works 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 ## Output 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. ## Request schema (JSON Schema) ```json { "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." … (truncated) ``` ## Response schema (JSON Schema) ```json { "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": [] } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aayat-ai-token-lookup-ccce7241/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from aayatai.com](https://www.zero.xyz/host/aayatai.com/llms.txt)