# FomoScan Token Theses Feed

> FomoScan Token Theses Feed is a paid API for AI agents from www.fomoscan.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns paginated trader theses (trade write-ups with PnL and holdings) for a specific token by its mint address or 0x contract address, newest first.

## Facts

- Endpoint: GET https://www.fomoscan.dev/v2/thesis/token/Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fomoscan-token-theses-feed-87886302
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pDCvKINWJp_QonJzLoq_9

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 fomoscan-token-theses-feed-87886302
```

Example prompt: Pull up what FOMO traders are saying about the token with mint address Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump — I want to see their write-ups, PnL, and how much they're holding, starting from the newest.

## When to prefer this

Use this endpoint when you have a specific token mint address (Solana) or 0x contract address (EVM) and want to see what FOMO traders are saying about it, including their PnL and holdings. Prefer this over the global feed when you need token-specific thesis data, and over the user-thesis endpoint when you want all traders' opinions on a token rather than one trader's history.

## Known failure modes

- Invalid or non-existent token address returns empty results or 404
- Passing a user handle or user ID instead of a token address causes incorrect or empty results
- Invalid 'before' cursor causes pagination errors or repeated results
- Rate limit or payment failure returns 402 or 429
- Network timeout on high-traffic tokens with many theses

## How this service works

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.

## Output

A paginated list of trader theses for the given token, each containing the trader's written thesis, their PnL on the token, their current holdings, author metadata, and a nextBefore cursor for retrieving older entries. Includes a hasMore flag indicating whether additional pages exist.

## 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",
      "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fomoscan-token-theses-feed-87886302/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.fomoscan.dev](https://www.zero.xyz/host/www.fomoscan.dev/llms.txt)