# CoinGecko API: List crypto categories

> Lists CoinGecko crypto sectors by market cap with daily change, volume, leading coins and category pages, optionally filtered by name or link.

Unofficial. Not affiliated with or endorsed by CoinGecko.

- Page: https://fous.com/methods/coingecko.com/list-crypto-categories
- Method: `coingecko.com/list_crypto_categories`, version 1
- Website: coingecko.com
- Returns: category name, market cap, 24h change, volume, top 3 coins, category link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `category` | string | no | `"Meme"` | Category name, part of a name, category link, or category ID; for example, Meme or Artificial Intelligence. Leave blank for all categories. Default "". |
| `max_results` | integer | no | `5` | Maximum number of categories, for example 50 (up to 200). Default 50. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "category": "Meme",
  "max_results": 5
}
```

Its output:

```json
{
  "categories": [
    {
      "category_link": "https://www.coingecko.com/en/categories/meme-token",
      "category_name": "Meme",
      "market_cap_usd": 29901289067.534084,
      "volume_24h_usd": 1956101653.6085272,
      "top_coin_1_name": "Dogecoin",
      "top_coin_2_name": "Shiba Inu",
      "top_coin_3_name": "Pump.fun",
      "market_cap_change_24h_percent": 1.1352795333420356
    },
    {
      "category_link": "https://www.coingecko.com/en/categories/solana-meme-coins",
      "category_name": "Solana Meme",
      "market_cap_usd": 3122049209.0300956,
      "volume_24h_usd": 519360489.4065774,
      "top_coin_1_name": "Pudgy Penguins",
      "top_coin_2_name": "Official Trump",
      "top_coin_3_name": "Bonk",
      "market_cap_change_24h_percent": 1.438976513925379
    },
    {
      "category_link": "https://www.coingecko.com/en/categories/ip-meme",
      "category_name": "IP Meme",
      "market_cap_usd": 814359221.7508816,
      "volume_24h_usd": 144591117.44046223,
      "top_coin_1_name": "Pudgy Penguins",
      "top_coin_2_name": "ApeCoin",
      "top_coin_3_name": "cat in a dogs world",
      "market_cap_change_24h_percent": 2.292148338249442
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"coingecko.com/list_crypto_categories","input":{"category":"Meme","max_results":5}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Show me the crypto sectors ranked by market cap with their 24h change and trading volume
- Which CoinGecko categories are gaining the most today, and what are their top 3 coins?
- Find the Meme coin category and tell me its market cap, volume, and leading tokens
- List up to 25 crypto categories including Artificial Intelligence, with links to their pages
- What are the biggest DeFi sectors right now by volume, and which coins lead each one?

## Input schema

```json
{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "default": "",
      "description": "Category name, part of a name, category link, or category ID; for example, Meme or Artificial Intelligence. Leave blank for all categories."
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum number of categories, for example 50 (up to 200)."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "categories"
  ],
  "properties": {
    "categories": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "category_link": {
            "type": "string"
          },
          "category_name": {
            "type": "string"
          },
          "market_cap_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "volume_24h_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "top_coin_1_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "top_coin_2_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "top_coin_3_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "market_cap_change_24h_percent": {
            "type": [
              "number",
              "null"
            ]
          }
        }
      }
    }
  }
}
```

## See more

- [CoinGecko API: List trending coins](https://fous.com/methods/coingecko.com/list-trending-coins.md): Lists up to 15 of the most-searched coins on CoinGecko in trending order, with price and 24-hour change in the chosen currency. Non-USD prices may be unavailable for some coins.
- [CoinGecko API: Get coin price history](https://fous.com/methods/coingecko.com/get-coin-price-history.md): Gets a coin's daily prices and price change over the last 7, 30, 90 or 365 days, with UTC dates. Today's price may change.
- [CoinGecko API: Get coin price on date](https://fous.com/methods/coingecko.com/get-coin-price-on-date.md): Gets a coin's price, market cap and 24-hour volume at 00:00 UTC on a past date. Non-USD currencies are available only for the last 365 days.
- [Polymarket API: List trending markets](https://fous.com/methods/polymarket.com/list-trending-markets.md): Lists the open Polymarket markets with the most trading in the last 24 hours. You can pick one category or list all of them; markets outside the named categories are labeled Other.
- [Twitch API: List top categories](https://fous.com/methods/twitch.tv/list-top-categories.md): Lists Twitch games and categories ranked by current live viewers, with content tags, box art and category links.
- [CoinMarketCap API: List top coins by market cap](https://fous.com/methods/coinmarketcap.com/list-top-coins.md): Lists the largest cryptocurrencies on CoinMarketCap ranked by market cap. Each coin comes with its price, changes, volume and supply in the chosen currency.
- [Arena API: Get leaderboard](https://fous.com/methods/arena.ai/get-leaderboard.md): Gets the ranked AI models of an LMArena (Arena) leaderboard with scores, confidence intervals, votes, organizations, licenses and the date the leaderboard was last updated.
- [Similarweb API: List top websites](https://fous.com/methods/similarweb.com/list-top-websites.md): Lists Similarweb's most visited websites for a category and country, with rankings and engagement figures for the reported month. Anonymous view limits may restrict results, especially for country rankings.
- [All CoinGecko methods](https://fous.com/methods/coingecko.com.md)
