{"uid":"cap_1vwMi7xBJW_hpiTuWUVCo","slug":"x4o2-fomo-token-list-d64fc56b","name":"x4o2 FOMO Token List","description":"One of the token lists on FOMO's discover tab, with market data per token (price, market cap, 24h volume and change, liquidity, holders, launchpad and graduation state): trending, most-held (what FOMO traders hold most), graduated (launchpad tokens that completed their curve), community or verified.","url":"https://fomo.x4o2.com/v1/tokens/:list?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":["list"],"properties":{"list":{"enum":["trending","most-held","graduated","community","verified"],"type":"string","description":"Which list"}}},"queryParams":{"type":"object","required":[],"properties":{"limit":{"type":"integer","default":50,"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"]},"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":{}}},"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_N64a8A27ZsCi7kgnZ0D56","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":"Returns a ranked list of tokens from FOMO's discover tab (trending, most-held, graduated, community, or verified) with price, market cap, 24h volume/change, liquidity, holders, and launchpad graduation state.","exampleAgentPrompt":"Pull the top 25 trending tokens from FOMO's discover tab right now — I want to see price, market cap, 24h change, liquidity, and holder count for each.","exampleUseCases":[{"title":"Monitor trending tokens for alpha","prompt":"What are the top 50 trending tokens on FOMO right now? Show me their prices, 24h changes, and holder counts so I can spot early movers."},{"title":"Track graduated launchpad tokens","prompt":"Give me the latest graduated tokens on FOMO — the ones that completed their bonding curve — with their market caps, liquidity, and how many holders each has."},{"title":"See what FOMO traders are holding","prompt":"Show me the 30 tokens that FOMO traders hold the most, with current price, 24h volume, and market cap for each."}],"resultDescription":"An array of token objects each containing: token address, name, symbol, decimals, network ID, image URLs, social links, launchpad name and icon, graduation percentage, plus market data including price, market cap, 24h volume, 24h price change, liquidity, and holder count. Also includes response metadata.","failureModes":["Invalid list enum value (not one of trending/most-held/graduated/community/verified) returns an error","limit out of range (must be 1–100) returns a validation error","Stale cache miss may cause slight delay on first request","Payment failure (insufficient USDC balance) blocks the request","Network timeout if upstream FOMO data is temporarily unavailable"],"whenToPreferThis":"Use this endpoint when you need a ranked, categorized snapshot of tokens from FOMO's curated discover lists with full market data in a single call. Prefer it over token search when you want a ranked feed rather than a specific token lookup, and over candle history when you only need current market snapshots rather than historical price series.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T12:34:11.149Z","isFirstParty":false,"canonicalSlug":"x4o2-fomo-token-list-d64fc56b"}