# CoinGecko Coins Markets

> CoinGecko Coins Markets is a paid API for AI agents from gateway.apiosk.com, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Returns a list of cryptocurrency market data (price, volume, market cap) for coins priced in a specified fiat or crypto currency

## Facts

- Endpoint: GET https://gateway.apiosk.com/coingecko/coins/markets
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coingecko-coins-markets-7992b44b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hij5FmX9lDwMsu0b3oemP

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-7992b44b
```

Example prompt: Pull the top 25 cryptocurrencies by market cap priced in USD from CoinGecko so I can see their current prices and market caps.

## When to prefer this

Use this endpoint when you need a ranked list of cryptocurrency market data (prices, market caps, volumes) across many coins in a single call, especially when you need the data denominated in a specific fiat or crypto currency. Prefer this over single-coin endpoints when you need a market overview or leaderboard. The pay-per-call USDC pricing via x402 makes it suitable for agents that need on-demand crypto market snapshots without a subscription.

## Known failure modes

- Missing required vs_currency parameter returns a 400 or validation error
- Invalid vs_currency value (unsupported currency code) may return empty results or an error
- Rate limiting or upstream CoinGecko API unavailability returns a 5xx error
- Invalid per_page value (e.g. exceeding max allowed) may cause an error or be silently capped
- Payment failure on x402 protocol results in 402 response before data is returned

## How this service works

Market data (price, market cap, volume, 24h change) for coins, ranked.

## Output

Returns an array of coin objects each containing coin id, symbol, name, image, current price, market cap, market cap rank, total volume, price change percentage over 24h, and other market statistics, all denominated in the requested vs_currency.

## More

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