{"uid":"cap_cYgFrBzrd1RNGsaD9-f2l","slug":"fomo-token-search-e50b254f","name":"FOMO Token Search","description":"FOMO's token search across the chains it trades: matches name, symbol or address and returns each token's address, network id, metadata and market data. Use to resolve a name or ticker to a chain and address for the /v1/token routes.","url":"https://fomo.x4o2.com/v1/search?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"},"pathParams":{"type":"object","required":[],"properties":{}},"queryParams":{"type":"object","required":[],"properties":{"q":{"type":"string","description":"Name, ticker or address, up to 100 characters"},"limit":{"type":"integer","default":20,"maximum":100,"minimum":1,"description":"Number of entries, 1-100"},"stale":{"enum":[0,1],"type":"integer","description":"1 returns any cached copy immediately and refreshes in the background"},"maxAge":{"type":"integer","minimum":0,"description":"Serve a cached copy up to this many seconds old; 0 forces the freshest allowed"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","meta"],"properties":{"data":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"token":{"type":["object","null"],"properties":{"info":{"type":["object","null"],"properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"symbol":{"type":["string","null"]},"totalSupply":{"type":["string","null"]},"imageLargeUrl":{"type":["string","null"]},"imageSmallUrl":{"type":["string","null"]},"imageThumbUrl":{"type":["string","null"]},"imageThumbHash":{"type":["string","null"]},"circulatingSupply":{"type":["string","null"]}}},"name":{"type":["string","null"]},"symbol":{"type":["string","null"]},"address":{"type":["string","null"]},"decimals":{"type":["number","null"]},"launchpad":{"type":["object","null"],"properties":{"launchpadName":{"type":["string","null"]},"launchpadIconUrl":{"type":["string","null"]},"graduationPercent":{"type":["number","null"]}}},"networkId":{"type":["number","null"]},"socialLinks":{"type":["object","null"],"properties":{"discord":{},"twitter":{"type":["string","null"]},"website":{"type":["string","null"]},"telegram":{"type":["string","null"]}}}}},"holders":{"type":["number","null"]},"change24":{"type":["string","null"]},"priceUSD":{"type":["string","null"]},"volume24":{"type":["string","null"]},"createdAt":{"type":["number","null"]},"liquidity":{"type":["string","null"]},"marketCap":{"type":["string","null"]}}}},"meta":{"type":"object","required":["observedAt","ageMs","source"],"properties":{"ageMs":{"type":"integer","description":"Age of the oldest part when served, ms"},"parts":{"type":"object","description":"observedAt and source per upstream part"},"source":{"enum":["cache","fresh","stale"],"type":"string"},"observedAt":{"type":"integer","description":"Unix ms when the oldest part was observed upstream"}},"description":"Freshness of the response"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8JYRJ3cOeROMH6p0U83c1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for crypto tokens by name, ticker symbol, or contract address across all chains FOMO trades, returning chain, address, metadata, and market data.","exampleAgentPrompt":"Search FOMO for the token 'PEPE' and give me its contract address and which blockchain it's on so I can pull its market data.","exampleUseCases":[{"title":"Resolve ticker to contract address","prompt":"I want to trade BONK on FOMO — can you look it up by ticker and tell me its contract address and which chain it's on?"},{"title":"Disambiguate token by full name","prompt":"Search FOMO for 'Wrapped Ether' and return all matching tokens with their addresses and network IDs so I can pick the right one."},{"title":"Verify token before fetching market data","prompt":"Before I pull the price chart, search FOMO for the token at address 0x6982508145454ce325ddbe47a25d4ec3d2311933 and confirm its name, symbol, and chain."}],"resultDescription":"Returns an array of matching token objects, each containing the token's contract address, network ID, name, symbol, decimals, image URLs, social links, launchpad graduation info, circulating supply, total supply, and associated market data such as price, market cap, and 24h volume. Also includes response metadata.","failureModes":["Empty result array when no tokens match the query string","Stale cached data returned if maxAge or stale parameters are used","Truncated results if limit is set too low and many tokens share a name","No results for very new or obscure tokens not yet indexed by FOMO","Rate limit or payment errors if x402 payment is not properly handled"],"whenToPreferThis":"Use this endpoint when you need to resolve a token name, ticker, or address into a canonical chain+address pair before calling other FOMO token routes (e.g. /v1/token). It is the correct entry point whenever the user provides a symbol or partial name rather than a full contract address, or when you need to discover which network a token is deployed on.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T12:35:12.758Z","isFirstParty":false,"canonicalSlug":"fomo-token-search-e50b254f"}