{"uid":"cap_xb_joBx_jc_YKBZR5zEO0","slug":"fomo-token-thesis-feed-fc08a287","name":"FOMO Token Thesis Feed","description":"The thesis feed for one token: the text each FOMO trader attached to their trade, who posted it, like and reply counts, when it was posted and the trade it belongs to. Pass thread=<tradeId> to also return the reply thread under one thesis. Use to read trader sentiment and reasoning on a token.","url":"https://fomo.x4o2.com/v1/token/:chain/:address/theses?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":{"limit":{"type":"string","description":"Number of theses, 1-100"},"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"},"thread":{"type":"string","description":"Trade id (uuid) whose reply thread to include"}}}},"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_2ndH9O0mh2XzMU7P6gEAw","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 thesis feed for a specific token on FOMO — trader-written reasoning texts, author info, engagement counts, timestamps, and optionally reply threads for a given trade.","exampleAgentPrompt":"Pull up the FOMO thesis feed for the Solana token at address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v — show me the last 20 theses including any reply threads, and give me a fresh copy rather than a cached one.","exampleUseCases":[{"title":"Token sentiment research before buying","prompt":"Before I buy into this Base token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, can you pull the latest FOMO trader theses and show me what people are writing about it — their reasoning, how many likes each got, and when they posted?"},{"title":"Debate thread under a specific trade","prompt":"There's a FOMO trade I saw earlier with id a3f2c1d0-8e4b-4f7a-b2d6-123456789abc on Ethereum — can you fetch the thesis plus its full reply thread so I can read the discussion traders are having about it?"},{"title":"Monitoring community conviction on a token","prompt":"I'm tracking sentiment on a Solana memecoin at DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 — grab the 50 most recent FOMO theses posted by traders so I can gauge how bullish or bearish the community is feeling right now."}],"resultDescription":"A list of thesis objects each containing the trader's written reasoning text, their FOMO handle and user ID, the number of likes and replies, the timestamp posted, and the associated trade ID. If the thread query param is provided, also returns the full reply thread under that trade's thesis.","failureModes":["Invalid or unsupported chain identifier returns an error","Token address not found on the specified chain returns empty or 404","Trade ID for thread param not recognized returns missing thread data","Rate limiting or payment failure for the $0.001 USDC per call charge","Stale cache miss when maxAge=0 and fresh data is unavailable may cause latency spike","Limit parameter out of range (not 1-100) returns validation error"],"whenToPreferThis":"Use this endpoint when you need the qualitative, human-written reasoning that FOMO platform traders attach to their trades — not just price or volume data. It is the right choice when the goal is understanding trader sentiment, reading community conviction, or following the discussion thread on a specific trade. Prefer it over generic social sentiment APIs when you specifically want FOMO platform users' on-chain-linked commentary.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:30:06.992Z","isFirstParty":false,"canonicalSlug":"fomo-token-thesis-feed-fc08a287"}