# FomoScan User Lookup by Handle

> FomoScan User Lookup by Handle is a paid API for AI agents from www.fomoscan.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Resolves a FOMO trader's profile by their public @handle, returning stable user ID, name, bio, and verified blockchain addresses.

## Facts

- Endpoint: GET https://www.fomoscan.dev/v2/user/handle/OfficeWorker
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fomoscan-user-lookup-by-handle-ddbc493e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1ku_9EE5-cMhz0ASDkJ7a

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-lookup-by-handle-ddbc493e
```

Example prompt: Can you look up the FOMO trader with handle OfficeWorker and get me their stable user ID, bio, and verified wallet addresses?

## When to prefer this

Use this endpoint when you have a FOMO trader's public @handle (without the @ symbol) and need to resolve it to a stable user ID or verified blockchain addresses. Prefer the handle-based endpoint over wallet or ID lookups when you only have a social username. Once you have the stable user ID from this call, switch to the ID-based endpoint for all subsequent lookups to avoid stale handle issues.

## Known failure modes

- Handle not found — returns 404 if the @handle does not exist on FOMO
- Incorrect input type — passing a wallet address or numeric ID instead of a plain handle will fail; only bare handles (no @) are accepted
- Payment failure — the x402 payment of $0.1 USDC must succeed or the request is rejected
- Handle changed — the resolved handle may differ from what was searched if the user recently renamed; always persist the returned ID

## How this service works

Resolve a FOMO trader by public handle (the @name on FOMO, without @). Use when you have a handle and not a stored user id. Returns id, handle, name, bio, and verified solanaAddress/evmAddress. Persist id — handles can change. Do not pass a wallet or numeric id.

## Output

Returns a JSON object containing the trader's stable numeric user ID, current handle, display name, bio text, and their verified solanaAddress and evmAddress (either may be null if not linked). The stable ID should be persisted for future lookups since handles can change.

## 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",
     "properties": {}
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fomoscan-user-lookup-by-handle-ddbc493e/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)