{"uid":"cap_GHjWZI-10EhIuqxwSc1aU","slug":"fomoscan-token-theses-feed-2a5ae2a7","name":"FomoScan Token Theses Feed","description":"Theses about one token (mint or 0x contract), newest first — what traders are saying plus their PnL/holdings on that token. Use when you have a token address. Page with ?before= from nextBefore. Do not pass a user id or handle as tokenAddress.","url":"https://www.fomoscan.dev/v2/thesis/token/0xa901f8e924eb9e2d30d4b8b92f92e71f7ebd1120?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","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_JL1H9FTbi8IqdL4NvdsDZ","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":"Returns a paginated list of trader theses (trade write-ups) for a specific token, newest first, including each trader's PnL and holdings on that token.","exampleAgentPrompt":"Pull the latest trader theses from FomoScan for the token at contract address 0xa901f8e924eb9e2d30d4b8b92f92e71f7ebd1120 — I want to see what people are saying and their PnL on it.","exampleUseCases":[{"title":"Token sentiment before aping in","prompt":"Before I buy into this token, can you pull the latest FOMO trader theses for the contract 0xa901f8e924eb9e2d30d4b8b92f92e71f7ebd1120 and show me what people are saying along with their PnL?"},{"title":"Due diligence on a Solana memecoin","prompt":"I've got this Solana mint address — can you grab the newest trader theses from FomoScan for it so I can see who's holding it and what their thesis is?"},{"title":"Scroll through paginated thesis history","prompt":"I already got the first page of theses for token 0xa901f8e924eb9e2d30d4b8b92f92e71f7ebd1120 on FomoScan — now give me the next page using the nextBefore cursor from the last result."}],"resultDescription":"A paginated list of trader theses for the specified token, ordered newest first. Each thesis includes the trade write-up text, the author's FOMO profile, their PnL on the token, their current holdings, and a nextBefore cursor for fetching subsequent pages.","failureModes":["Token address not found or no theses exist — returns empty list","Invalid token address format (e.g. passing a user handle instead of a mint/contract) — returns error or empty result","Malformed before cursor — may return unexpected page or error","Rate limit exceeded — HTTP 429","Payment required not fulfilled — HTTP 402"],"whenToPreferThis":"Use this endpoint when you have a specific token's mint address (Solana) or 0x contract address (EVM) and want to retrieve what FOMO traders are saying about it along with their PnL and holdings. Prefer this over the global thesis feed when you need token-specific sentiment. Do not use this for user-based lookups — use the trader-by-handle or trader-by-wallet endpoints instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T00:32:14.034Z","isFirstParty":false,"canonicalSlug":"fomoscan-token-theses-feed-87886302"}