# CoinGecko Coins Markets

> CoinGecko Coins Markets is a paid API for AI agents from CoinGecko at coingecko.mpp.paywithlocus.com, paid per call via MPP, $0.06/call, status unknown (last checked 2026-10-09).

Fetches paginated market data (price, market cap, volume, etc.) for cryptocurrencies in a specified fiat or crypto currency

## Facts

- Endpoint: POST https://coingecko.mpp.paywithlocus.com/coingecko/coins-markets?utm_source=zero.xyz
- Price: $0.06/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Provider: CoinGecko
- Docs: https://docs.coingecko.com
- Website: https://www.coingecko.com
- Tags: crypto, prices, market-cap, exchanges, trending, data
- Canonical page: https://www.zero.xyz/c/coingecko-coins-markets-55a42fc4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_T_ztzOH9mrXZDR8QITdWS

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-55a42fc4 -d '<json body>'
```

Example prompt: Pull the top 10 cryptocurrencies by market cap in USD from CoinGecko, including their 24h and 7d price change percentages, and sort them by market cap descending.

## When to prefer this

Use this endpoint when you need bulk paginated market data for many coins at once, including rankings, volume, supply, and price change statistics. Prefer over Simple Price when you need market cap ranks, volume, supply info, ATH/ATL, or sparkline data. Prefer over Coin Data when you need a list of coins rather than deep detail on a single coin. Best for building leaderboards, market overviews, portfolio snapshots, or screeners.

## Known failure modes

- Missing required vs_currency field returns a 400/validation error
- Invalid coin ID in ids filter silently omits unrecognized coins or returns empty array
- Invalid sort order string may return default ordering without error
- Requesting more than 250 per_page may be capped or return an error
- Rate limiting or upstream CoinGecko unavailability returns 429 or 503
- Invalid category string may return empty results without clear error message

## How this service works

Get market data (price, market cap, volume, sparkline) for coins with pagination.

## Output

Returns an array of coin market objects, each containing: coin ID, symbol, name, image URL, current price, market cap, market cap rank, fully diluted valuation, total volume, 24h high/low, price changes (absolute and percentage) over requested intervals, circulating/total/max supply, all-time high and low with dates and percentage changes, last updated timestamp, and optionally 7-day sparkline price arrays. Results are paginated.

## Example request

```json
{
 "page": 1,
 "order": "market_cap_desc",
 "per_page": 10,
 "sparkline": false,
 "vs_currency": "usd",
 "price_change_percentage": "1h,24h,7d"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "vs_currency"
 ],
 "properties": {
  "ids": {
   "type": "string",
   "description": "Comma-separated coin IDs to filter"
  },
  "page": {
   "type": "number",
   "description": "Page number"
  },
  "order": {
   "type": "string",
   "description": "Sort order (e.g. \"market_cap_desc\")"
  },
  "category": {
   "type": "string",
   "description": "Filter by category"
  },
  "per_page": {
   "type": "number",
   "description": "Results per page (1-250, default 100)"
  },
  "sparkline": {
   "type": "boolean",
   "description": "Include 7-day sparkline data"
  },
  "vs_currency": {
   "type": "string",
   "description": "Target currency (e.g. \"usd\")"
  },
  "price_change_percentage": {
   "type": "string",
   "description": "Price change intervals (e.g. \"1h,24h,7d\")"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coingecko-coins-markets-55a42fc4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from coingecko.mpp.paywithlocus.com](https://www.zero.xyz/host/coingecko.mpp.paywithlocus.com/llms.txt)