# CurveCall Token Search

> CurveCall Token Search is a paid API for AI agents from curvecall.onrender.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-11).

Search for cryptocurrency tokens by name, symbol, or contract address, optionally filtered by chain, returning price, liquidity, and DEX listing data

## Facts

- Endpoint: GET https://curvecall.onrender.com/v1/search?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/curvecall-token-search-46ed9b74
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sjOJJEJ3ZtXeMsnZyaDIE

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 curvecall-token-search-46ed9b74
```

Example prompt: Search for tokens named 'PEPE' on the Base chain and show me the top 5 results including their price, liquidity, and which DEX they trade on.

## When to prefer this

Use this endpoint when an agent needs to resolve a token name, symbol, or partial address into actionable market data (price, liquidity, DEX) and a canonical contract address, especially for tokens on Base or Solana. Prefer this over generic web search when structured token data with DexScreener sourcing is needed for downstream trading or risk analysis workflows.

## Known failure modes

- No results found for obscure or misspelled token names
- Chain filter value not recognized returns empty or error
- Limit exceeding 25 causes validation error
- Payment failure (402) if x402 micropayment not processed
- Token address on wrong chain returns no match
- Ambiguous symbol (e.g. 'ETH') may return many low-quality results

## How this service works

Token search

## Output

Returns a list of up to 25 matching tokens, each with chain, symbol, contract address, top DEX name, current USD price, USD liquidity, and a DexScreener URL. Also includes the total count and the query echoed back.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "queryParams": {
     "q": {
      "type": "string",
      "required": true,
      "description": "Token name, symbol or address to search"
     },
     "chain": {
      "type": "string",
      "required": false,
      "description": "Optional chain filter, e.g. base, solana"
     },
     "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 25,
      "required": false
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "chain": null,
     "count": 10,
     "query": "pepe",
     "source": "dexscreener search",
     "results": [
      {
       "url": "https://dexscreener.com/base/0x...",
       "chain": "base",
       "symbol": "PEPE",
       "address": "0x...",
       "top_dex": "uniswap",
       "price_usd": 0.00001,
       "liquidity_usd": 250000
      }
     ]
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/curvecall-token-search-46ed9b74/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from curvecall.onrender.com](https://www.zero.xyz/host/curvecall.onrender.com/llms.txt)