# SperaxOS CoinGecko Token Search

> SperaxOS CoinGecko Token Search is a paid API for AI agents from chat.sperax.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-02).

Searches for cryptocurrency tokens by name or symbol using CoinGecko data, payable per-request via x402 USDC micropayment

## Facts

- Endpoint: POST https://chat.sperax.io/api/x402/tools/coingecko/searchTokens?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/speraxos-coingecko-token-search-6edddf83
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YjIOdv3GT80ikrCnn_jHw

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 speraxos-coingecko-token-search-6edddf83 -d '<json body>'
```

Example prompt: Search for all tokens matching 'uniswap' on CoinGecko and give me their names, symbols, and IDs.

## When to prefer this

Use this endpoint when you need to resolve a token name or symbol to a CoinGecko ID without managing API keys, especially in agent workflows that pay per call via USDC on Base. Prefer over direct CoinGecko API when you want keyless, micropayment-based access integrated into an x402-compatible payment flow.

## Known failure modes

- No tokens found for obscure or misspelled query — returns empty result set
- Payment failure if insufficient USDC balance on Base for x402 micropayment
- Rate limiting or upstream CoinGecko API unavailability causing 5xx errors
- Ambiguous query returning many results requiring further filtering by the caller

## How this service works

AI-powered DeFi intelligence APIs payable via the x402 HTTP payment protocol. No API key required — pay per request with USDC on Base. Identity-only (SIWX) endpoints are free for wallets with an agentcash identity.

## Output

Returns a list of matching tokens from CoinGecko, typically including each token's name, symbol, and CoinGecko coin ID, enabling downstream lookups of price, market data, or contract addresses.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "description": "Search query — token name or symbol (e.g. \"uniswap\", \"LINK\")."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/speraxos-coingecko-token-search-6edddf83/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chat.sperax.io](https://www.zero.xyz/host/chat.sperax.io/llms.txt)