# SperaxOS CoinGecko Market Chart API

> SperaxOS CoinGecko Market Chart 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-03).

Fetches historical price, market cap, and volume chart data for a given cryptocurrency over a specified number of days via CoinGecko, payable per-request with USDC on Base.

## Facts

- Endpoint: POST https://chat.sperax.io/api/x402/tools/coingecko/getMarketChart?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-03
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/speraxos-coingecko-market-chart-api-9bf05698
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tialQK17sR9axkYR6KheH

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-market-chart-api-9bf05698 -d '<json body>'
```

Example prompt: Pull the CoinGecko market chart data for bitcoin over the last 30 days so I can see how the price and volume have moved.

## When to prefer this

Choose this endpoint when you need historical price, market cap, or volume chart data for a specific cryptocurrency without managing API keys — ideal for DeFi agents that already hold USDC on Base and want pay-per-use access to CoinGecko data. Prefer this over direct CoinGecko API calls when operating in a keyless, on-chain payment environment.

## Known failure modes

- Invalid coinId returns an error or empty result — must use CoinGecko's exact coin ID (e.g. 'bitcoin', not 'BTC')
- Payment failure if the caller's USDC balance on Base is insufficient
- Days parameter out of supported range may return partial or error response
- Rate limiting or upstream CoinGecko API downtime causing 5xx errors
- Malformed request body missing required coinId field

## 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 time series of historical price, market cap, and total volume data points for the specified coin over the given number of days, as sourced from CoinGecko. Each data point is typically a [timestamp, value] pair.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "number",
   "description": "Number of days of history (e.g. 1, 7, 30, 90, 365). Default: 7."
  },
  "coinId": {
   "type": "string",
   "description": "CoinGecko coin ID (e.g. \"bitcoin\")."
  }
 }
}
```

## More

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