# pump.x4o2.com Coin Search

> pump.x4o2.com Coin Search is a paid API for AI agents from pump.x4o2.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-16).

Search pump.fun coins by name, ticker symbol, description, or mint address, returning full coin records ranked by USD market cap.

## Facts

- Endpoint: GET https://pump.x4o2.com/v1/coins/search?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/pump-x4o2-com-coin-search-fb7d6546
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yCxUW_FvE2K7LzcBZsaKh

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 pump-x4o2-com-coin-search-fb7d6546
```

Example prompt: Search pump.fun for coins matching 'DOGE' and show me the top 5 results with their mint addresses and current USD market caps.

## When to prefer this

Use this endpoint when you need to resolve a human-readable coin name, ticker, or description keyword to a pump.fun mint address, or when you want to discover coins matching a theme. Prefer this over the coin list endpoint when you have a specific search term rather than wanting a sorted paginated list. It is the canonical way to go from ticker → mint on pump.fun.

## Known failure modes

- No results returned when search query is too specific or misspelled
- Stale market cap data if cache is used (controlled via maxAge/stale params)
- Mint address queries that don't exactly match return no results
- Rate limiting or payment failure at $0.001 USDC per call if wallet is insufficient
- offset+limit combination may return empty page if pagination exceeds total results

## How this service works

pump.fun's coin search: matches on name, symbol, description or mint, ranked by USD market cap. Returns full coin records (mint, metadata, market cap, creator, bonding-curve state). Use to resolve a ticker or name to a mint.

## Output

Returns an array of full pump.fun coin records ranked by USD market cap. Each record includes the mint address, coin name, ticker symbol, description, image metadata, creator wallet, current market cap in USD, and bonding-curve or AMM state (e.g. whether the coin has graduated from the bonding curve).

## 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": "Search text (name, ticker, mint or description), 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"
      },
      "offset": {
       "type": "integer",
       "maximum": 100000,
       "minimum": 0,
       "description": "Pagination offset"
      }
     }
    }
   },
   "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": {
         "mint": {
          "type": [
           "string",
           "null"
          ]
         },
         "name": {
          "type": [
           "string",
           "null"
          ]
         },
         "nsfw": {
          "type": [
           "boolean",
           "null"
          ]
         },
         "depth": {
          "type": [
           "number",
           "null"
          ]
         },
         "hidden": {
          "type": [
           "boolean",
           "null"
          ]
         },
         "symbol": {
          "type": [
           "string",
           "null"
          ]
         },
         "creator": {
   
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pump-x4o2-com-coin-search-fb7d6546/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pump.x4o2.com](https://www.zero.xyz/host/pump.x4o2.com/llms.txt)