{"uid":"cap_HB8O_pQdfpNTt6gra2YJ8","slug":"fomoscan-user-token-thesis-lookup-bd309efe","name":"FomoScan - User+Token Thesis Lookup","description":"Theses by one trader about one token. Use when you have both a stable user id and a token address — more targeted than listing all of a user's theses. {id} is user id, not handle. Page with ?before= from nextBefore.","url":"https://www.fomoscan.dev/v2/thesis/user/aefe2ddd-c580-5245-a2f5-e4ed62f7ef10/token/Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"before":{"type":"string","description":"Thesis id cursor from the previous page's nextBefore. Omit for the newest page. Pass nextBefore as-is while hasMore is true."}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nCSpz3ERdLKpryCtEbiSf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a paginated list of trade theses written by a specific FOMO trader about a specific token, filtered by both user ID and token address.","exampleAgentPrompt":"Pull all of FOMO user aefe2ddd-c580-5245-a2f5-e4ed62f7ef10's theses about the token Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump and show me their PnL and what they wrote.","exampleUseCases":[{"title":"Track a trader's conviction on one token","prompt":"Show me everything that FOMO trader aefe2ddd-c580-5245-a2f5-e4ed62f7ef10 has written about the token Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump — all their theses, PnL, and current holdings."},{"title":"Monitor a whale's repeated token commentary","prompt":"I want to see all the trade write-ups from FOMO user aefe2ddd-c580-5245-a2f5-e4ed62f7ef10 specifically about Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump — have they been consistently bullish or have they changed their view over time?"},{"title":"Paginate through historical thesis feed","prompt":"I already fetched the first page of theses for that FOMO user on that token — now get me the next page using the nextBefore cursor from the last result."}],"resultDescription":"Returns a newest-first paginated list of trade theses written by the specified user about the specified token, including thesis text, PnL data, holdings, and pagination metadata (nextBefore cursor and hasMore flag) for fetching additional pages.","failureModes":["User ID not found — returns 404 if the UUID does not match any FOMO user","Token address not found — returns 404 if no theses exist for that token","No theses for the user-token pair — returns empty list when the user has never written about that token","Invalid cursor — malformed or expired ?before= value may return an error or empty page","Malformed user ID — non-UUID format rejected","Payment failure — x402 payment not processed, returns 402"],"whenToPreferThis":"Use this endpoint when you have both a stable FOMO user ID (UUID) and a specific token address and want only that trader's theses about that specific token. It is more targeted and efficient than fetching all theses for a user and filtering client-side. Prefer it over the global feed endpoint or the per-user endpoint when you need the intersection of a specific author and a specific asset.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:40:49.161Z","isFirstParty":false}