# CoinGecko Top Gainers & Losers via Locus x402

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

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

## Facts

- Endpoint: POST https://coingecko.x402.paywithlocus.com/coingecko/top-gainers-losers
- 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-top-gainers-losers-via-locus-x402-5faa846d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n7gIC5XvO8kqN78ph2wSN

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-via-locus-x402-5faa846d -d '<json body>'
```

Example prompt: What are the top crypto gainers and losers over the last 24 hours among the top 500 coins, priced in USD?

## When to prefer this

Use this endpoint when you need a ranked list of top gaining or losing coins across a defined time window and market cap tier. It is ideal for momentum screening, daily briefings, or identifying market leaders and laggards. Prefer this over general price endpoints when the goal is comparative performance ranking rather than looking up a specific coin's price.

## Known failure modes

- Invalid duration value returns an error — must be one of: 1h, 24h, 7d, 14d, 30d, 60d, 1y
- Invalid top_coins value returns an error — must be a supported tier like 300, 500, or 1000
- Unsupported vs_currency causes a failed response
- Payment failure via x402 protocol results in a 402 response and no data returned
- CoinGecko upstream downtime or rate limiting may cause delayed or empty responses

## How this service works

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

## Output

A JSON object containing lists of top gaining and top losing coins for the specified time period, including coin identifiers, price change percentages, and market data, along with payment settlement details and request tracking information.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "duration": {
   "type": "string"
  },
  "top_coins": {
   "type": "string"
  },
  "vs_currency": {
   "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-top-gainers-losers-via-locus-x402-5faa846d/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)