# CoinGecko Top Gainers & Losers

> CoinGecko Top Gainers & Losers 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-10).

Returns the top gaining and losing cryptocurrencies over a specified time period, filtered by market cap tier and quoted in a target currency.

## Facts

- Endpoint: POST https://coingecko.mpp.paywithlocus.com/coingecko/top-gainers-losers?utm_source=zero.xyz
- Price: $0.06/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-10
- 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-top-gainers-losers-19c5d959
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UwcXpNw4NDtpgAsfHUKQr

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-top-gainers-losers-19c5d959 -d '<json body>'
```

Example prompt: Show me the top gaining and losing coins in USD over the last 24 hours, looking only at the top 500 coins by market cap.

## When to prefer this

Use this endpoint when you need a quick ranked view of the best and worst performing cryptocurrencies over a defined time window. Ideal for market scanning, alerting on big movers, or building a daily crypto briefing. Prefer this over Coins Markets when you specifically want performance-ranked gainers/losers rather than a full market list sorted by cap.

## Known failure modes

- Missing required vs_currency field returns a validation error
- Invalid duration value (e.g. '48h') may return empty results or an error
- top_coins value outside allowed options (300, 500, 1000) may be rejected or ignored
- Rate limiting or upstream CoinGecko API unavailability returns a 5xx error
- Currency code not supported by CoinGecko returns an empty or error response

## How this service works

Get top 30 coins with largest price gains and losses over a time period.

## Output

A ranked list of top-gaining and top-losing cryptocurrency coins for the specified period, including each coin's price change percentage, current price in the target currency, and market cap rank — truncated to the most notable movers within the requested top_coins universe.

## Example request

```json
{
 "duration": "24h",
 "top_coins": "500",
 "vs_currency": "usd"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "vs_currency"
 ],
 "properties": {
  "duration": {
   "type": "string",
   "description": "Time period: \"1h\", \"24h\", \"7d\", \"14d\", \"30d\", \"60d\", \"1y\""
  },
  "top_coins": {
   "type": "string",
   "description": "Filter by top N coins (e.g. \"300\", \"500\", \"1000\")"
  },
  "vs_currency": {
   "type": "string",
   "description": "Target currency (e.g. \"usd\")"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coingecko-top-gainers-losers-19c5d959/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)