{"uid":"cap_P60gjZih2RyFltrpgmSzI","slug":"fomo-trader-leaderboard-57ff2a7c","name":"FOMO Trader Leaderboard","description":"FOMO's leaderboard of its best traders: rank, handle, user id, profile picture and P&L for the period (24h, 7d, 30d or all time). Use to find traders worth following, then look them up with /v1/profile/{handle}.","url":"https://fomo.x4o2.com/v1/leaderboard?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":{"limit":{"type":"integer","default":100,"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"},"period":{"enum":["24h","7d","30d","all"],"type":"string","default":"24h","description":"Leaderboard window"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","meta"],"properties":{"data":{"type":["object","null"],"properties":{"leaderboard":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"id":{"type":["string","null"]},"clan":{"type":["object","null"],"properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"iconLink":{"type":["string","null"]},"iconThumbhash":{"type":["string","null"]}}},"pnl24h":{"type":["number","null"]},"address":{"type":["string","null"]},"private":{"type":["boolean","null"]},"twitter":{},"verified":{"type":["boolean","null"]},"activated":{"type":["boolean","null"]},"clanBadge":{"type":["object","null"],"properties":{"text":{"type":["string","null"]},"type":{"type":["string","null"]},"image":{"type":["string","null"]},"title":{"type":["string","null"]},"metadata":{"type":["object","null"],"properties":{"clanId":{"type":["string","null"]},"memberType":{"type":["string","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"]},"topHoldings":{"type":["array","null"],"items":{"type":["object","null"],"properties":{"pnl":{"type":["number","null"]},"price":{"type":["number","null"]},"value":{"type":["number","null"]},"imageUrl":{"type":["string","null"]},"networkId":{"type":["number","null"]},"humanAmount":{"type":["number","null"]},"tokenAddress":{"type":["string","null"]}}}},"totalVolume":{"type":["number","null"]},"isRestricted":{"type":["boolean","null"]},"totalHoldings":{"type":["number","null"]},"coverPhotoLink":{"type":["string","null"]},"profilePictureLink":{"type":["string","null"]},"coverPhotoThumbhash":{"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_bMryEjxswA5YjvI_K0ODR","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 FOMO's ranked list of top traders with rank, handle, user ID, profile picture, and P&L for a chosen time window (24h, 7d, 30d, or all-time).","exampleAgentPrompt":"Show me the top 20 traders on FOMO's leaderboard for the past 7 days so I can find some good ones to follow.","exampleUseCases":[{"title":"Discover top weekly crypto traders","prompt":"Who are the top 25 traders on FOMO over the last 7 days? I want to find some profitable ones to follow."},{"title":"All-time best performer research","prompt":"Pull FOMO's all-time leaderboard — show me the top 50 traders by P&L so I can see who the consistent earners are."},{"title":"Daily top trader snapshot","prompt":"Give me today's FOMO leaderboard — the top 10 traders by 24-hour P&L — I want to see who's crushing it right now."}],"resultDescription":"A ranked array of trader entries, each containing: rank position, handle, user ID, profile picture URL, P&L for the selected period, follower count, verification status, clan membership and badge, wallet address, and account metadata. Also includes response metadata (cache age, period, total count).","failureModes":["Invalid period value returns 400 error","Limit out of range (below 1 or above 100) returns 400","Service unavailable returns 5xx","Stale cache miss may cause slight delay on first fresh fetch","Payment failure (x402) blocks access if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need to discover or rank traders on the FOMO platform by profitability across a specific time window. It's the go-to for finding traders worth following before looking them up individually via the profile endpoint. Prefer this over searching by handle when you don't know specific traders yet and want a ranked discovery view.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T12:31:00.429Z","isFirstParty":false,"canonicalSlug":"fomo-trader-leaderboard-57ff2a7c"}