# CoinGecko Markets Data via StableCrypto

> CoinGecko Markets Data via StableCrypto is a paid API for AI agents from stablecrypto.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Fetches paginated, sorted cryptocurrency market data (prices, market caps, volume, supply) for one or more coins against a target currency

## Facts

- Endpoint: POST https://stablecrypto.dev/api/coingecko/markets
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coingecko-markets-data-via-stablecrypto-95aba7d5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CGLGZ_x9PNN1SNnoANSQS

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-markets-data-via-stablecrypto-95aba7d5 -d '<json body>'
```

Example prompt: Show me the top 25 cryptocurrencies by market cap in USD, sorted by market_cap_desc, including their 24h and 7d price change percentages — give me page 1 with 25 results per page.

## When to prefer this

Use this endpoint when you need structured, paginated cryptocurrency market data proxied through CoinGecko, especially when you want to filter by specific coin IDs, sort by market cap or volume, or retrieve multi-field market snapshots (price, supply, ATH/ATL) in a single call. Prefer this over symbol-only price lookups when you need rich market context like rank, supply metrics, or all-time highs.

## Known failure modes

- Missing required vs_currency field returns 400 error
- Invalid coin ID in ids array returns empty result or null fields
- Unsupported vs_currency value causes malformed response
- per_page exceeding 250 may be rejected or clamped
- Network or upstream CoinGecko outage returns 5xx
- Payment not included or insufficient results in 402 Payment Required

## How this service works

Pay-per-request access to CoinGecko, DefiLlama, Alchemy, and Etherscan APIs. No auth, no subscriptions.

## Output

An array of coin objects each containing: id, name, symbol, image, current price, market cap, market cap rank, fully diluted valuation, total volume, 24h high/low, price change (absolute and percentage) over 24h, market cap change over 24h, circulating supply, total supply, max supply, all-time high and low with dates and change percentages, and last updated timestamp.

## Example request

```json
{
 "ids": [
  "bitcoin",
  "ethereum"
 ],
 "page": 1,
 "order": "market_cap_desc",
 "per_page": 25,
 "sparkline": false,
 "vs_currency": "usd",
 "price_change_percentage": "1h,24h,7d"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ids": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Filter by coin IDs"
  },
  "page": {
   "type": "number"
  },
  "order": {
   "type": "string",
   "description": "Sort order (e.g. \"market_cap_desc\")"
  },
  "category": {
   "type": "string"
  },
  "per_page": {
   "type": "number",
   "description": "Results per page (max 250)"
  },
  "sparkline": {
   "type": "boolean"
  },
  "vs_currency": {
   "type": "string",
   "description": "Target currency (e.g. \"usd\")"
  },
  "price_change_percentage": {
   "type": "string",
   "description": "Comma-separated intervals (e.g. \"1h,24h,7d\")"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coingecko-markets-data-via-stablecrypto-95aba7d5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablecrypto.dev](https://www.zero.xyz/host/stablecrypto.dev/llms.txt)