# FOMO Token Search

> FOMO Token Search 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).

Search for crypto tokens by name, ticker symbol, or contract address across all chains FOMO trades, returning chain, address, metadata, and market data.

## Facts

- Endpoint: GET https://fomo.x4o2.com/v1/search?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-token-search-e50b254f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cYgFrBzrd1RNGsaD9-f2l

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-token-search-e50b254f
```

Example prompt: Search FOMO for the token 'PEPE' and give me its contract address and which blockchain it's on so I can pull its market data.

## When to prefer this

Use this endpoint when you need to resolve a token name, ticker, or address into a canonical chain+address pair before calling other FOMO token routes (e.g. /v1/token). It is the correct entry point whenever the user provides a symbol or partial name rather than a full contract address, or when you need to discover which network a token is deployed on.

## Known failure modes

- Empty result array when no tokens match the query string
- Stale cached data returned if maxAge or stale parameters are used
- Truncated results if limit is set too low and many tokens share a name
- No results for very new or obscure tokens not yet indexed by FOMO
- Rate limit or payment errors if x402 payment is not properly handled

## How this service works

FOMO's token search across the chains it trades: matches name, symbol or address and returns each token's address, network id, metadata and market data. Use to resolve a name or ticker to a chain and address for the /v1/token routes.

## Output

Returns an array of matching token objects, each containing the token's contract address, network ID, name, symbol, decimals, image URLs, social links, launchpad graduation info, circulating supply, total supply, and associated market data such as price, market cap, and 24h volume. 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": [],
     "properties": {}
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "q": {
       "type": "string",
       "description": "Name, ticker or address, up to 100 characters"
      },
      "limit": {
       "type": "integer",
       "default": 20,
       "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": [
               "string",
               "null"
              ]
             },
             "imageLargeUrl": {
              "type"
… (truncated)
```

## More

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