{"uid":"cap_4ZS6_m-0Lpzqpz5ZLK6ql","slug":"fomo-user-profile-lookup-284a65d4","name":"FOMO User Profile Lookup","description":"The public profile of one FOMO user by handle: id, follower and following counts, swap and trade counts, total volume, average hold time and recent P&L. Add include=trades,balances,rank to also return their trade history, current token balances and leaderboard rank. Use to evaluate a trader seen in holder or activity data.","url":"https://fomo.x4o2.com/v1/profile/:handle?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":["handle"],"properties":{"handle":{"type":"string","description":"FOMO user handle"}}},"queryParams":{"type":"object","required":[],"properties":{"stale":{"type":"string","description":"1 returns any cached copy immediately and refreshes in the background"},"maxAge":{"type":"string","description":"Serve a cached copy up to this many seconds old; 0 forces the freshest allowed"},"include":{"type":"string","description":"Comma-separated extras: trades, balances, rank, spotlight"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"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_d00ru71mC99SgZyYV4gdJ","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":"Retrieves a FOMO trader's public profile including follower/following counts, swap/trade counts, volume, average hold time, recent P&L, and optionally their trade history, token balances, and leaderboard rank.","exampleAgentPrompt":"Pull up the FOMO profile for the trader with handle 'cryptoking99' — include their trade history, current token balances, and leaderboard rank so I can decide if they're worth following.","exampleUseCases":[{"title":"Evaluate a whale spotted in holder data","prompt":"I just saw a wallet show up as a top holder of this new token — their FOMO handle is 'whalehunter'. Can you pull their FOMO profile including trade history and recent P&L so I can tell if they're a smart money trader?"},{"title":"Copy-trading due diligence","prompt":"Before I start mirroring this trader's moves, look up their FOMO profile for handle 'degen_alpha' — I want to see their total volume, average hold time, win rate, and leaderboard rank."},{"title":"Leaderboard competitor research","prompt":"I'm competing on the FOMO leaderboard — can you pull the profile for handle 'toptrader88' and include their rank and current token balances so I can see what they're holding?"}],"resultDescription":"Returns a JSON object with the FOMO user's public profile data: their internal ID, follower and following counts, total swap and trade counts, cumulative volume, average hold time, and recent P&L. With optional includes: full trade history (buys/sells/transfers), current token balances with positions, and their leaderboard rank.","failureModes":["Handle not found — returns 404 if the username does not exist on FOMO","Stale cache served if maxAge is set and a cached copy exists within the TTL","Rate limiting or payment failure — 402 response if x402 payment is not included or fails","Empty trade history if the user has no recorded trades","Partial data if optional include parameters are not specified"],"whenToPreferThis":"Use this endpoint when you have a specific FOMO user handle and need to evaluate that trader's performance metrics, portfolio, or standing. Ideal for due diligence on traders discovered via token holder lists or activity feeds on FOMO. Prefer this over generic on-chain analytics when you want FOMO-specific social signals (followers, leaderboard rank, posted theses) alongside trading metrics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:36:11.733Z","isFirstParty":false,"canonicalSlug":"fomo-user-profile-lookup-284a65d4"}