# Agent402 Coin Categories List

> Agent402 Coin Categories List is a paid API for AI agents from agent402.tools, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns a ranked list of cryptocurrency coin categories (e.g. DeFi, Layer-2, Meme) with market cap, 24h volume, and top coins, sourced from CoinGecko.

## Facts

- Endpoint: GET https://agent402.tools/api/coin-categories
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-coin-categories-list-c6f5b244
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2BxpBocrWzJeOTZ63GKc5

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 agent402-coin-categories-list-c6f5b244
```

Example prompt: Show me the top 10 crypto coin categories ranked by market cap descending, and filter for anything related to 'layer-2'.

## When to prefer this

Choose this endpoint when you need a structured, ranked list of crypto market sectors or themes (DeFi, NFT, Layer-2, Meme, etc.) with associated market cap and volume data. It is ideal for building sector dashboards, screening for hot categories, or populating category filters in analytics tools. Prefer it over a raw CoinGecko integration when you want a pay-per-call, no-signup approach via x402 with USDC micropayments.

## Known failure modes

- Invalid 'order' enum value returns a validation error
- limit outside 1-100 range may return an error or be clamped
- query substring with no matches returns an empty categories array with count 0
- Upstream CoinGecko outage may return a 502 or stale cached data
- Payment failure (insufficient USDC) results in a 402 response before the call is processed

## How this service works

Coin categories (Layer 1, Meme, AI, DeFi, Stablecoins, RWA, ...) ranked by market cap, with 24h market cap change %, 24h volume and the top-3 coins per category. Order by market_cap_desc (default), market_cap_asc, market_cap_change_24h_desc/asc, name_asc/desc; optional `query` substring filter on category name/id; limit 1-100 (default 25). The sector-rotation view: which narratives are gaining or bleeding today. Cached in-process for 5 minutes.

## Output

A JSON object containing: the count of returned categories, the applied sort order, cache status, source (CoinGecko), fetch timestamp, and an array of category objects each with id, name, rank, top coin ids, market cap in USD, 24h volume, 24h market cap change percentage, and last updated timestamp. Also includes a totalCategories field indicating the full universe of tracked categories.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "number",
       "description": "1-100 (default 25)."
      },
      "order": {
       "type": "string",
       "description": "market_cap_desc (default), market_cap_asc, market_cap_change_24h_desc, market_cap_change_24h_asc, name_asc, name_desc."
      },
      "query": {
       "type": "string",
       "description": "Optional case-insensitive substring filter on the category name or id (e.g. \"meme\", \"layer-2\")."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "source",
      "fetchedAt",
      "cached",
      "order",
      "count",
      "totalCategories",
      "categories"
     ],
     "properties": {
      "count": {
       "type": "integer"
      },
      "order": {
       "type": "string"
      },
      "cached": {
       "type": "boolean"
      },
      "source": {
       "type": "string"
      },
      "fetchedAt": {
       "type": "string"
      },
      "categories": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "totalCategories": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "order": "market_cap_desc",
  "cached": false,
  "source": "coingecko",
  "fetchedAt": "2026-08-22T13:20:00.000Z",
  "categories": [
   {
    "id": "smart-contract-platform",
    "name": "Smart Contract Platform",
    "rank": 1,
    "topCoins": [
     "bitcoin",
     "ethereum",
     "solana"
    ],
    "marketCap": 2261471553524.96,
    "updatedAt": "2026-08-22T13:15:00.000Z",
    "volume24h": 95000000000,
    "marketCapChange24hPct": 1.1784
   }
  ],
  "totalCategories": 400
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-coin-categories-list-c6f5b244/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)