# 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-10-18).

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.

## Facts

- Endpoint: GET https://www.fomoscan.dev/v2/thesis/token/0xa901f8e924eb9e2d30d4b8b92f92e71f7ebd1120?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fomoscan-token-theses-feed-2a5ae2a7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GHjWZI-10EhIuqxwSc1aU

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-2a5ae2a7
```

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

## When to prefer this

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.

## Known failure modes

- 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

## 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 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.

## 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-2a5ae2a7/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)