# Crypto Spot Price by CoinGecko ID

> Crypto Spot Price by CoinGecko ID is a paid API for AI agents from conclavex402p04.pythonanywhere.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-14).

Returns live USD spot price, 24-hour percentage change, and market cap for one or more cryptocurrencies identified by CoinGecko ID, sourced from a keyless multi-source chain that avoids upstream rate limits.

## Facts

- Endpoint: GET https://conclavex402p04.pythonanywhere.com/v1/price?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-spot-price-by-coingecko-id-c8a02f7c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UkYk4bGfsmQLyyYGQto4Y

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 crypto-spot-price-by-coingecko-id-c8a02f7c
```

Example prompt: What are the current USD spot prices, 24-hour changes, and market caps for bitcoin and ethereum right now?

## When to prefer this

Choose this endpoint when you need live crypto spot prices without managing API keys or worrying about CoinGecko rate limits (429s). It supports batch lookups for multiple coins in one call and provides staleness metadata so callers can judge data freshness — making it ideal for payment settlement, portfolio valuation, and pricing decisions where latency and reliability matter.

## Known failure modes

- Invalid or unknown CoinGecko ID returns missing or empty data for that coin
- Stale flag set to true with elevated staleness_sec when upstream sources are lagging
- Partial flag true when only some requested coins returned data
- Malformed query params (wrong format for ids) may yield empty data object
- Network timeout from pythonanywhere host results in HTTP 5xx

## How this service works

Call before pricing or settling a crypto payment: live spot prices for one or more coins by CoinGecko id (USD price, 24h change, market cap) from a keyless multi-source chain that never returns an upstream 429.

## Output

A JSON object keyed by CoinGecko coin ID, each containing the USD spot price, market cap, and 24-hour percentage change, plus top-level metadata: the currency denomination, whether data is stale, staleness in seconds, the data source (e.g. coingecko), and whether the response is partial.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "pathParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "vs": "usd",
  "ids": "bitcoin,ethereum",
  "data": {
   "bitcoin": {
    "usd": 60000,
    "mcap": 1180000000000,
    "chg24h": 1.2
   },
   "ethereum": {
    "usd": 3000,
    "mcap": 360000000000,
    "chg24h": -0.5
   }
  },
  "route": "price",
  "stale": false,
  "source": "coingecko",
  "partial": false,
  "staleness_sec": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-spot-price-by-coingecko-id-c8a02f7c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from conclavex402p04.pythonanywhere.com](https://www.zero.xyz/host/conclavex402p04.pythonanywhere.com/llms.txt)
