# SperaxOS CoinGecko Token Price API

> SperaxOS CoinGecko Token Price API 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-12).

Returns the current USD price of a cryptocurrency token by CoinGecko coin ID or symbol, payable via x402 micro-payment

## Facts

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

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-price-api-a060b547 -d '<json body>'
```

Example prompt: What's the current price of Ethereum? Look it up using the CoinGecko coin ID 'ethereum'.

## When to prefer this

Choose this endpoint when you need a real-time spot price for a specific cryptocurrency and want to pay per call without an API key setup. It is ideal for AI agents operating autonomously with a Base wallet, DeFi workflows that need live pricing, or any scenario where the CoinGecko coin ID is known. Prefer coinId over symbol for unambiguous results.

## Known failure modes

- Invalid or unrecognized coinId returns an error — ensure the coin ID matches CoinGecko's naming (e.g. 'bitcoin' not 'Bitcoin')
- Unknown symbol with no coinId fallback results in a not-found error
- Payment failure via x402 (insufficient USDC balance on Base) blocks the request
- Rate limiting or CoinGecko upstream downtime may cause delayed or failed responses
- Ambiguous symbol (e.g. 'LUNA' mapping to multiple tokens) may return unexpected results without explicit coinId

## 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

The current USD price of the requested cryptocurrency token, sourced from CoinGecko. The response includes the token's live market price, enabling agents to perform portfolio calculations, DeFi strategy evaluations, or price comparisons.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "coinId": {
   "type": "string",
   "description": "CoinGecko coin ID (e.g. \"bitcoin\", \"ethereum\", \"solana\"). Preferred over symbol."
  },
  "symbol": {
   "type": "string",
   "description": "Token symbol (e.g. \"BTC\", \"ETH\"). Used as fallback if coinId is not provided."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/speraxos-coingecko-token-price-api-a060b547/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)