# x4o2 FOMO Token List

> x4o2 FOMO Token List 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-28).

Returns a ranked list of tokens from FOMO's discover tab (trending, most-held, graduated, community, or verified) with price, market cap, 24h volume/change, liquidity, holders, and launchpad graduation state.

## Facts

- Endpoint: GET https://fomo.x4o2.com/v1/tokens/:list?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x4o2-fomo-token-list-d64fc56b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1vwMi7xBJW_hpiTuWUVCo

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 x4o2-fomo-token-list-d64fc56b
```

Example prompt: Pull the top 25 trending tokens from FOMO's discover tab right now — I want to see price, market cap, 24h change, liquidity, and holder count for each.

## When to prefer this

Use this endpoint when you need a ranked, categorized snapshot of tokens from FOMO's curated discover lists with full market data in a single call. Prefer it over token search when you want a ranked feed rather than a specific token lookup, and over candle history when you only need current market snapshots rather than historical price series.

## Known failure modes

- Invalid list enum value (not one of trending/most-held/graduated/community/verified) returns an error
- limit out of range (must be 1–100) returns a validation error
- Stale cache miss may cause slight delay on first request
- Payment failure (insufficient USDC balance) blocks the request
- Network timeout if upstream FOMO data is temporarily unavailable

## How this service works

One of the token lists on FOMO's discover tab, with market data per token (price, market cap, 24h volume and change, liquidity, holders, launchpad and graduation state): trending, most-held (what FOMO traders hold most), graduated (launchpad tokens that completed their curve), community or verified.

## Output

An array of token objects each containing: token address, name, symbol, decimals, network ID, image URLs, social links, launchpad name and icon, graduation percentage, plus market data including price, market cap, 24h volume, 24h price change, liquidity, and holder count. Also includes response metadata.

## 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": [
      "list"
     ],
     "properties": {
      "list": {
       "enum": [
        "trending",
        "most-held",
        "graduated",
        "community",
        "verified"
       ],
       "type": "string",
       "description": "Which list"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 50,
       "maximum": 100,
       "minimum": 1,
       "description": "Number of entries, 1-100"
      },
      "stale": {
       "enum": [
        0,
        1
       ],
       "type": "integer",
       "description": "1 returns any cached copy immediately and refreshes in the background"
      },
      "maxAge": {
       "type": "integer",
       "minimum": 0,
       "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data",
      "meta"
     ],
     "properties": {
      "data": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "object",
         "null"
        ],
        "properties": {
         "token": {
          "type": [
           "object",
           "null"
          ],
          "properties": {
           "info": {
            "type": [
             "object",
             "null"
            ],
            "properties": {
             "id": {
              "type": [
               "string",
               "null"
              ]
             },
             "name": {
              "type": [
               "string",
               "null"
              ]
             },
             "symbol": {
              "type": [
               "string",
               "null"
              ]
             },
             "totalSupply": {
              "type": [
          
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x4o2-fomo-token-list-d64fc56b/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)