{"uid":"cap_58zF96IWu9RD32pe88hn7","slug":"x4o2-fomo-bulk-profiles-lookup-a80bc83f","name":"x4o2 FOMO Bulk Profiles Lookup","description":"Many FOMO traders at once: ids= (up to 50 user ids, one upstream read) or handles= (up to 25, one read each). Each entry is the profile with Solana (address) and EVM (evmAddress) wallets; include=rank adds rank = { all, 24h, 7d, 30d } of { rank, pnl } per user (one extra read each). Unknown ids or handles go to data.notFound instead of failing the call. Use to rank or enrich traders collected from holders, followers, following or the feed: the way to ranks beyond the leaderboard's top 150.","url":"https://fomo.x4o2.com/v1/profiles?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":{"ids":{"type":"string","description":"Comma-separated FOMO user ids (uuid), 1-50; exclusive with handles"},"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"},"handles":{"type":"string","description":"Comma-separated FOMO handles, 1-25; exclusive with ids"},"include":{"type":"string","description":"Comma-separated extras: rank"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","meta"],"properties":{"data":{"type":["object","null"],"properties":{"users":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"id":{"type":["string","null"]},"clan":{"type":["object","null"]},"rank":{"type":["object","null"]},"badge":{"type":["object","null"]},"address":{"type":["string","null"]},"private":{"type":["boolean","null"]},"twitter":{},"verified":{"type":["boolean","null"]},"activated":{"type":["boolean","null"]},"clanBadge":{"type":["object","null"]},"createdAt":{"type":["string","null"]},"followers":{"type":["number","null"]},"following":{"type":["number","null"]},"numTrades":{"type":["number","null"]},"swapCount":{"type":["number","null"]},"thumbhash":{"type":["string","null"]},"evmAddress":{"type":["string","null"]},"isReferred":{"type":["boolean","null"]},"userHandle":{"type":["string","null"]},"description":{"type":["string","null"]},"displayName":{"type":["string","null"]},"totalVolume":{"type":["number","null"]},"isRestricted":{"type":["boolean","null"]},"coverPhotoLink":{"type":["string","null"]},"friendsFollowing":{"type":["array","null"]},"followsCurrentUser":{"type":["boolean","null"]},"profilePictureLink":{"type":["string","null"]},"coverPhotoThumbhash":{"type":["string","null"]},"numFriendsFollowing":{"type":["number","null"]},"averageHoldTimeSeconds":{"type":["number","null"]}}}},"notFound":{"type":["array","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_XL7F0K0pJ_swYZ3O_Vv_K","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":"Fetch FOMO trader profiles in bulk by user IDs or handles, optionally including all-time and period-specific PnL ranks","exampleAgentPrompt":"Pull the FOMO profiles for these trader IDs — a1b2c3d4-..., e5f6g7h8-..., and i9j0k1l2-... — and include their 24h, 7d, 30d, and all-time PnL ranks so I can see who's performing best right now.","exampleUseCases":[{"title":"Rank traders from token holders","prompt":"I've got a list of 40 FOMO user IDs collected from holders of a token — can you pull all their profiles including 7d and 30d PnL ranks so I can sort them by recent performance?"},{"title":"Resolve handles to wallet addresses","prompt":"I have these 20 FOMO handles from a token's follower list: handle1, handle2, handle3... can you fetch their profiles and give me their Solana and EVM wallet addresses?"},{"title":"Discover rank beyond leaderboard top 150","prompt":"The FOMO leaderboard only shows 150 traders, but I want to see all-time and 24h ranks for these specific traders I'm following — can you look them up by their FOMO IDs and include the rank data?"}],"resultDescription":"Returns a data object with a users array, each entry containing the trader's FOMO id, userHandle, displayName, Solana address, EVM address, follower/following counts, trade counts, clan, badge, verification status, and optionally a rank object with all/24h/7d/30d sub-objects each containing rank and PnL. Unknown ids or handles are returned in data.notFound rather than causing errors.","failureModes":["Exceeds 50 IDs or 25 handles limit — request is rejected","ids and handles used together — mutually exclusive, returns error","Unknown IDs or handles silently moved to data.notFound rather than failing","Stale cache returned when stale=1 is set — data may be outdated","include=rank adds one extra upstream read per user — latency increases with batch size","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need to enrich or rank a set of traders collected from token holders, follower lists, or the feed, especially when you need to go beyond the leaderboard's top-150 cap. Prefer over single-profile endpoints when batching up to 50 users at once. Use ids= for efficiency (single upstream read for all 50); use handles= when only handles are available. This is the right endpoint when you need wallet addresses (Solana and EVM) for a known set of FOMO users, or when you want to overlay PnL rank data onto any user collection.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:30:40.825Z","isFirstParty":false,"canonicalSlug":"x4o2-fomo-bulk-profiles-lookup-a80bc83f"}