# Crypto Spot Price Aggregator (Multi-Exchange Median)

> Crypto Spot Price Aggregator (Multi-Exchange Median) is a paid API for AI agents from kr-x402-mvp.kgy5612.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-01).

Returns median USD spot prices for top cryptocurrencies aggregated from up to 5 exchanges, with data quality signals including source count, dispersion, 24h change, and volume.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/api/coingecko/price?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-spot-price-aggregator-multi-exchange-median-0b7110aa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Jqt9RIEHwFZ7nnLSYJupd

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-aggregator-multi-exchange-median-0b7110aa
```

Example prompt: Can you get me the current median USD spot prices for BTC, ETH, and SOL, and let me know how many exchanges are agreeing on the price and what the 24h change looks like?

## When to prefer this

Choose this endpoint when you need a robust, manipulation-resistant spot price that aggregates across multiple major exchanges rather than trusting a single source. The dispersion_bps and n_sources fields are particularly valuable for trading agents that need to assess price reliability before executing. Prefer this over single-exchange price feeds when data quality signals matter, or when you need prices for the specific set of top-10 tokens it covers (BTC, ETH, SOL, BNB, XRP, DOGE, ADA, AVAX, LINK, SUI).

## Known failure modes

- Invalid or unsupported symbol returns an error or omits that symbol from results
- All upstream exchanges unresponsive results in no price data for affected symbols
- Network timeout from Cloudflare Worker causing 5xx response
- Requesting an unsupported symbol not in the documented list returns empty or error

## How this service works

Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.

## Output

A JSON object containing per-symbol data including the median USD price across responding exchanges, the number of sources (n_sources) that contributed, price dispersion in basis points (dispersion_bps), 24-hour price change, and 24-hour trading volume. Covers BTC, ETH, SOL by default; BNB, XRP, DOGE, ADA, AVAX, LINK, SUI also available.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "symbols": {
       "type": "string",
       "examples": [
        "BTC,ETH,SOL",
        "BTC"
       ],
       "description": "Comma-separated symbols (default BTC,ETH,SOL)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "prices": {
   "BTC": {
    "price_usd": 80867.7,
    "binance_usdt": 80860,
    "coinbase_usd": 80875.4,
    "change_24h_pct": 1.2
   }
  },
  "sources": [
   "https://api.binance.com",
   "https://api.coinbase.com"
  ],
  "updated_at": "2026-10-28T11:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-spot-price-aggregator-multi-exchange-median-0b7110aa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kr-x402-mvp.kgy5612.workers.dev](https://www.zero.xyz/host/kr-x402-mvp.kgy5612.workers.dev/llms.txt)
