# Crypto Spot Price

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

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

## Facts

- Endpoint: GET https://conclavex402.pythonanywhere.com/v1/price?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-spot-price-412a6624
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1D3IWcKlqoJ9n9yQNcL30

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-412a6624
```

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 for one or more coins by CoinGecko ID without managing API keys or worrying about upstream CoinGecko rate limits (429s). It is ideal for pre-payment pricing, settlement calculations, or multi-coin portfolio snapshots. Prefer it over direct CoinGecko API calls when operating in agentic or automated contexts that may exceed free-tier rate limits.

## Known failure modes

- Unknown CoinGecko ID returns missing or partial data with partial:true
- Upstream data temporarily stale returns stale:true with staleness_sec indicating age
- Missing required query params (ids) returns an error response
- Invalid vs currency parameter may return unsupported currency error
- Network timeout from pythonanywhere hosting on cold start

## 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 coin ID, each containing the USD spot price, 24-hour percentage change, and market cap. Also includes the data source (e.g. coingecko), a staleness flag, staleness in seconds, and whether the result 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-412a6624/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from conclavex402.pythonanywhere.com](https://www.zero.xyz/host/conclavex402.pythonanywhere.com/llms.txt)