{"uid":"cap_r3hn0Nsndr_0EmMhnwUwF","slug":"fomo-token-holders-leaderboard-b6cc9105","name":"FOMO Token Holders Leaderboard","description":"The FOMO users holding the most of a token: each holder's FOMO handle and id, token amount, position value, cost basis, realized and unrealized P&L, hold time, developer flag and their posted thesis. Covers holders who trade on FOMO, not every on-chain wallet. Use for social and holder analysis of a token.","url":"https://fomo.x4o2.com/v1/token/:chain/:address/holders?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":["chain","address"],"properties":{"chain":{"type":"string","description":"solana, base, ethereum, bsc, monad or a numeric network id"},"address":{"type":"string","description":"Token mint (Solana) or contract address (EVM)"}}},"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"}}}},"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_Tmbos6H_DMUYUs2BhKieb","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 the top holders of a token on FOMO, including each holder's social handle, position size, P&L, cost basis, hold time, developer flag, and posted thesis.","exampleAgentPrompt":"Who are the biggest FOMO holders of the token at address 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU on Solana, and what P&L and thesis have they posted?","exampleUseCases":[{"title":"Whale conviction check before investing","prompt":"Pull up the top FOMO holders of the Base token at 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed — I want to see their unrealized P&L and what thesis they posted when they bought in."},{"title":"Identifying developer wallets in holder list","prompt":"Which of the top holders of Solana token 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU on FOMO are flagged as developers? Show me their position sizes too."},{"title":"Social sentiment from top holders","prompt":"Grab the investment theses posted by the largest FOMO holders of the Ethereum token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 — I want to read what the biggest bulls are saying."}],"resultDescription":"An array of the top FOMO token holders, each containing the holder's FOMO handle and user ID, the amount of the token they hold, the current position value, their cost basis, realized and unrealized profit/loss, how long they have held the position, a boolean developer flag, and the text of any thesis they posted when entering the trade.","failureModes":["Unknown or unsupported chain identifier returns an error or empty result","Invalid or non-existent token address returns 404 or empty holders list","Token has no FOMO traders (all on-chain holders, none on FOMO platform) returns empty array","Stale cache with maxAge=0 may incur higher latency or a timeout","Rate limiting or payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need social-layer holder analysis — specifically for tokens traded on the FOMO platform — and want to combine on-chain position data (amount, P&L, cost basis) with social signals (FOMO handle, thesis text, developer flag). Prefer this over raw on-chain holder queries when the social identity, posted conviction thesis, and trader reputation context matter. Not suitable for comprehensive on-chain holder distribution across all wallets, as it only covers FOMO platform users.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:36:41.718Z","isFirstParty":false,"canonicalSlug":"fomo-token-holders-leaderboard-b6cc9105"}