# FOMO Trader Leaderboard

> FOMO Trader Leaderboard 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 FOMO's ranked list of top traders with rank, handle, user ID, profile picture, and P&L for a chosen time window (24h, 7d, 30d, or all-time).

## Facts

- Endpoint: GET https://fomo.x4o2.com/v1/leaderboard?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/fomo-trader-leaderboard-57ff2a7c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P60gjZih2RyFltrpgmSzI

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-trader-leaderboard-57ff2a7c
```

Example prompt: Show me the top 20 traders on FOMO's leaderboard for the past 7 days so I can find some good ones to follow.

## When to prefer this

Use this endpoint when you need to discover or rank traders on the FOMO platform by profitability across a specific time window. It's the go-to for finding traders worth following before looking them up individually via the profile endpoint. Prefer this over searching by handle when you don't know specific traders yet and want a ranked discovery view.

## Known failure modes

- Invalid period value returns 400 error
- Limit out of range (below 1 or above 100) returns 400
- Service unavailable returns 5xx
- Stale cache miss may cause slight delay on first fresh fetch
- Payment failure (x402) blocks access if USDC balance is insufficient

## How this service works

FOMO's leaderboard of its best traders: rank, handle, user id, profile picture and P&L for the period (24h, 7d, 30d or all time). Use to find traders worth following, then look them up with /v1/profile/{handle}.

## Output

A ranked array of trader entries, each containing: rank position, handle, user ID, profile picture URL, P&L for the selected period, follower count, verification status, clan membership and badge, wallet address, and account metadata. Also includes response metadata (cache age, period, total count).

## 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": [],
     "properties": {}
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 100,
       "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"
      },
      "period": {
       "enum": [
        "24h",
        "7d",
        "30d",
        "all"
       ],
       "type": "string",
       "default": "24h",
       "description": "Leaderboard window"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data",
      "meta"
     ],
     "properties": {
      "data": {
       "type": [
        "object",
        "null"
       ],
       "properties": {
        "leaderboard": {
         "type": [
          "array",
          "null"
         ],
         "items": {
          "type": [
           "object",
           "null"
          ],
          "properties": {
           "id": {
            "type": [
             "string",
             "null"
            ]
           },
           "clan": {
            "type": [
             "object",
             "null"
            ],
            "properties": {
             "id": {
              "type": [
               "string",
               "null"
              ]
             },
             "name": {
              "type": [
               "string",
               "null"
              ]
             },
             "iconLink": {
              "type": [
               "string",
               "null"
    
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fomo-trader-leaderboard-57ff2a7c/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)