# FomoScan - User+Token Thesis Lookup

> FomoScan - User+Token Thesis Lookup 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).

Retrieves a paginated list of trade theses written by a specific FOMO trader about a specific token, filtered by both user ID and token address.

## Facts

- Endpoint: GET https://www.fomoscan.dev/v2/thesis/user/aefe2ddd-c580-5245-a2f5-e4ed62f7ef10/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-user-token-thesis-lookup-bd309efe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HB8O_pQdfpNTt6gra2YJ8

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-user-token-thesis-lookup-bd309efe
```

Example prompt: Pull all of FOMO user aefe2ddd-c580-5245-a2f5-e4ed62f7ef10's theses about the token Ai66LHZG9MCzg1WKdawwqduVAXpNDUuV8M3uyq5ppump and show me their PnL and what they wrote.

## When to prefer this

Use this endpoint when you have both a stable FOMO user ID (UUID) and a specific token address and want only that trader's theses about that specific token. It is more targeted and efficient than fetching all theses for a user and filtering client-side. Prefer it over the global feed endpoint or the per-user endpoint when you need the intersection of a specific author and a specific asset.

## Known failure modes

- User ID not found — returns 404 if the UUID does not match any FOMO user
- Token address not found — returns 404 if no theses exist for that token
- No theses for the user-token pair — returns empty list when the user has never written about that token
- Invalid cursor — malformed or expired ?before= value may return an error or empty page
- Malformed user ID — non-UUID format rejected
- Payment failure — x402 payment not processed, returns 402

## How this service works

Theses by one trader about one token. Use when you have both a stable user id and a token address — more targeted than listing all of a user's theses. {id} is user id, not handle. Page with ?before= from nextBefore.

## Output

Returns a newest-first paginated list of trade theses written by the specified user about the specified token, including thesis text, PnL data, holdings, and pagination metadata (nextBefore cursor and hasMore flag) for fetching additional 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-user-token-thesis-lookup-bd309efe/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)