# CoinGecko Trending Coins via Locus x402

> CoinGecko Trending Coins 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).

Fetches the current list of trending cryptocurrencies on CoinGecko, including trending coins, NFTs, and categories by search popularity.

## Facts

- Endpoint: POST https://coingecko.x402.paywithlocus.com/coingecko/trending
- 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-trending-coins-via-locus-x402-b16500d0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aD8vNXRI7iV0hN-Ewuygj

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-trending-coins-via-locus-x402-b16500d0 -d '<json body>'
```

Example prompt: What cryptocurrencies are trending on CoinGecko right now? I want to see which coins, NFTs, and categories are the most searched and gaining the most attention today.

## When to prefer this

Choose this endpoint when you need real-time trending cryptocurrency data sourced from CoinGecko's search-popularity rankings and want to pay per-call via USDC using the x402 micropayment protocol — ideal for agents that need on-demand trend signals without managing a CoinGecko API subscription. Prefer this over direct CoinGecko API access when operating in a Web3-native, agent-driven environment where x402 payment rails are already in use.

## Known failure modes

- Payment failure: insufficient USDC balance or x402 payment not settled, resulting in 402 response
- CoinGecko API unavailability: upstream service outage causing 502 or 503 errors
- Rate limiting: too many requests in a short window returning 429
- Malformed request body causing 400 bad request
- Empty or stale data if CoinGecko hasn't refreshed trending list recently

## How this service works

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

## Output

Returns a structured JSON object containing lists of trending coins (with name, symbol, market cap rank, price data, and score), trending NFTs, and trending categories ranked by search popularity on CoinGecko over the past 24 hours. Also includes payment settlement details (USDC amount) and a request tracking ID.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {},
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## 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-trending-coins-via-locus-x402-b16500d0/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)