# FOMO User Profile Lookup

> FOMO User Profile Lookup 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-16).

Retrieves a FOMO trader's public profile including follower/following counts, swap/trade counts, volume, average hold time, recent P&L, and optionally their trade history, token balances, and leaderboard rank.

## Facts

- Endpoint: GET https://fomo.x4o2.com/v1/profile/:handle?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fomo-user-profile-lookup-284a65d4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4ZS6_m-0Lpzqpz5ZLK6ql

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-user-profile-lookup-284a65d4
```

Example prompt: Pull up the FOMO profile for the trader with handle 'cryptoking99' — include their trade history, current token balances, and leaderboard rank so I can decide if they're worth following.

## When to prefer this

Use this endpoint when you have a specific FOMO user handle and need to evaluate that trader's performance metrics, portfolio, or standing. Ideal for due diligence on traders discovered via token holder lists or activity feeds on FOMO. Prefer this over generic on-chain analytics when you want FOMO-specific social signals (followers, leaderboard rank, posted theses) alongside trading metrics.

## Known failure modes

- Handle not found — returns 404 if the username does not exist on FOMO
- Stale cache served if maxAge is set and a cached copy exists within the TTL
- Rate limiting or payment failure — 402 response if x402 payment is not included or fails
- Empty trade history if the user has no recorded trades
- Partial data if optional include parameters are not specified

## How this service works

The public profile of one FOMO user by handle: id, follower and following counts, swap and trade counts, total volume, average hold time and recent P&L. Add include=trades,balances,rank to also return their trade history, current token balances and leaderboard rank. Use to evaluate a trader seen in holder or activity data.

## Output

Returns a JSON object with the FOMO user's public profile data: their internal ID, follower and following counts, total swap and trade counts, cumulative volume, average hold time, and recent P&L. With optional includes: full trade history (buys/sells/transfers), current token balances with positions, and their leaderboard rank.

## 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": [
      "handle"
     ],
     "properties": {
      "handle": {
       "type": "string",
       "description": "FOMO user handle"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "stale": {
       "type": "string",
       "description": "1 returns any cached copy immediately and refreshes in the background"
      },
      "maxAge": {
       "type": "string",
       "description": "Serve a cached copy up to this many seconds old; 0 forces the freshest allowed"
      },
      "include": {
       "type": "string",
       "description": "Comma-separated extras: trades, balances, rank, spotlight"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fomo-user-profile-lookup-284a65d4/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)
