# Routheus Token Search API

> Routheus Token Search API is a paid API for AI agents from routheus.xyz, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Search for EVM tokens by address, symbol, or name fragment across 13+ chains, returning paginated token metadata from live DEX pool data

## Facts

- Endpoint: GET https://routheus.xyz/%7Bchain%7D/api/tokens/search?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/routheus-token-search-api-bcfc5515
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2t8OmjrL3hoXhswpu2kWW

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 routheus-token-search-api-bcfc5515
```

Example prompt: Search Routheus on the Base chain for tokens matching 'USDC' — I want to see the contract address, decimals, and how many DEX pools it appears in.

## When to prefer this

Use this endpoint when you need to resolve a token symbol, name, or partial address to a verified contract address and metadata on a specific EVM chain before constructing a swap or price query. It is especially useful in agentic DeFi workflows where the downstream swap or quote endpoint requires an exact contract address. Prefer this over generic blockchain explorers when you need DEX-specific signals like pool count and hub status, or when operating across 13+ EVM chains without managing separate API keys.

## Known failure modes

- Query returns empty token list if symbol or name has no match on the specified chain
- Invalid or unsupported chain identifier returns an error or empty result
- Malformed address fragment may return zero results
- Payment failure via x402 protocol blocks the request before execution
- Rate or quota issues if payment is not processed correctly
- Pagination out of bounds (page number exceeds total_pages) returns empty tokens array

## How this service works

Routheus: live DEX token prices and best-route swap quotes from a real-time pool-state engine, executable routes with calldata (Permit2), simulation-verified outputs, token metadata, search and pool data on 13+ EVM chains. Pay per call in USDC via x402 — no API keys, no subscription.

## Output

Returns a paginated list of tokens matching the query on the specified chain. Each token entry includes its name, symbol, contract address, decimals, pool count, and whether it is a hub token. Also includes total result count, current page, page size, and total pages for pagination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "page": {
   "type": "string",
   "description": "Page number"
  },
  "query": {
   "type": "string",
   "description": "Address, symbol or name fragment"
  },
  "page_size": {
   "type": "string",
   "description": "Page size"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "ok"
 ],
 "properties": {
  "ok": {
   "type": "boolean"
  },
  "page": {
   "type": "integer"
  },
  "total": {
   "type": "integer"
  },
  "tokens": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "name": {
      "type": "string"
     },
     "is_hub": {
      "type": "boolean"
     },
     "symbol": {
      "type": "string"
     },
     "address": {
      "type": "string"
     },
     "decimals": {
      "type": "integer"
     },
     "pool_count": {
      "type": "integer"
     }
    }
   }
  },
  "page_size": {
   "type": "integer"
  },
  "total_pages": {
   "type": "integer"
  }
 }
}
```

## More

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