# CoinGecko Coins Markets via Locus x402

> CoinGecko Coins Markets 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-09-14).

Fetches paginated cryptocurrency market data — prices, market caps, volume, and price change percentages — for one or more coins, paid per-call via x402 USDC micropayment.

## Facts

- Endpoint: POST https://coingecko.x402.paywithlocus.com/coingecko/coins-markets
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coingecko-coins-markets-via-locus-x402-f55472d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XK2luAcqpSt3Pv77kWVxk

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-coins-markets-via-locus-x402-f55472d1 -d '<json body>'
```

Example prompt: Pull the top 50 crypto coins by market cap in USD, including 24h and 7d price change percentages, sorted by market_cap_desc — I want the first page of results.

## When to prefer this

Prefer this endpoint when you need structured coin market data (prices, caps, volume, change %) for one or many coins in a single paginated call, especially when filtering by category or sorting by market cap — and when your agent runtime supports x402 USDC micropayments. It's a good fit over direct CoinGecko API access when you want pay-per-use with no API key management.

## Known failure modes

- Invalid coin ID returns empty data array or error
- Unsupported vs_currency value causes a 400-level error
- Page number out of range returns empty results
- per_page value outside 1-250 range may cause validation error
- Network or upstream CoinGecko outage returns 5xx
- Insufficient USDC payment causes x402 payment failure before data is returned

## How this service works

Cryptocurrency market data — prices, charts, market cap, exchanges, trending coins, global stats, NFTs, derivatives, and on-chain data.

## Output

Returns a JSON payload with an array of coin market objects (price, market cap, volume, price change percentages, rank, supply, optional sparkline) plus x402 payment settlement metadata including settled USDC amount and a request status URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ids": {
   "type": "string"
  },
  "page": {
   "type": "number"
  },
  "order": {
   "type": "string"
  },
  "category": {
   "type": "string"
  },
  "per_page": {
   "type": "number"
  },
  "sparkline": {
   "type": "boolean"
  },
  "vs_currency": {
   "type": "string"
  },
  "price_change_percentage": {
   "type": "string"
  }
 }
}
```

## 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-coins-markets-via-locus-x402-f55472d1/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)