# FOMO Token Thesis Feed

> FOMO Token Thesis Feed is a paid API for AI agents from fomo.x4o2.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-16).

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.

## Facts

- Endpoint: GET https://fomo.x4o2.com/v1/token/:chain/:address/theses?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fomo-token-thesis-feed-fc08a287
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xb_joBx_jc_YKBZR5zEO0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fomo-token-thesis-feed-fc08a287
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fomo-token-thesis-feed-fc08a287/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fomo.x4o2.com](https://www.zero.xyz/host/fomo.x4o2.com/llms.txt)