# CoinGecko Simple Price via Locus x402

> CoinGecko Simple Price via Locus x402 is a paid API for AI agents from coingecko.x402.paywithlocus.com, paid per call via x402, $0.06/call, status unknown (last checked 2026-10-13).

Fetches current prices for one or more cryptocurrencies in specified fiat or crypto currencies, with optional market cap, 24hr volume, and price change data.

## Facts

- Endpoint: POST https://coingecko.x402.paywithlocus.com/coingecko/simple-price?utm_source=zero.xyz
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coingecko-simple-price-via-locus-x402-3468130f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7S1UUp1vocW4slNpHJz79

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 coingecko-simple-price-via-locus-x402-3468130f -d '<json body>'
```

Example prompt: What are the current prices of bitcoin, ethereum, and solana in USD and EUR? Also include their 24-hour price change and market cap, with full decimal precision.

## When to prefer this

Use this endpoint when you need fast, simple spot-price lookups for one or more cryptocurrencies in specified currencies without needing historical data or complex chart series. It is ideal for portfolio valuation, price alert checks, and multi-coin price displays. Prefer it over full market endpoint calls when you only need prices and basic stats, not full token metadata. The pay-per-call x402 micropayment model means no API key management is needed.

## Known failure modes

- Invalid coin ID returns empty or missing key in response
- Unsupported vs_currency value may cause error or missing field
- Missing required ids or vs_currencies parameters causes request failure
- Payment failure (insufficient USDC balance) blocks the request
- Rate limiting or upstream CoinGecko API unavailability returns error
- Malformed comma-separated list causes partial or failed lookup

## How this service works

Locus public pay-per-use API

## Output

A JSON object keyed by coin ID, each containing current price(s) in the requested currencies, and optionally market cap, 24hr volume, 24hr change percentage, and last updated Unix timestamp. Also includes payment settlement metadata (settled USDC amount, request ID, status URL) confirming the micropayment was processed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ids": {
   "type": "string"
  },
  "precision": {
   "type": "string"
  },
  "vs_currencies": {
   "type": "string"
  },
  "include_24hr_vol": {
   "type": "boolean"
  },
  "include_market_cap": {
   "type": "boolean"
  },
  "include_24hr_change": {
   "type": "boolean"
  },
  "include_last_updated_at": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "payment": {
   "scheme": "exact",
   "settledUsdc": "0.001000",
   "authorizedMaxUsdc": "0.001000"
  },
  "request": {
   "id": "00000000-0000-4000-8000-000000000000",
   "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coingecko-simple-price-via-locus-x402-3468130f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from coingecko.x402.paywithlocus.com](https://www.zero.xyz/host/coingecko.x402.paywithlocus.com/llms.txt)