---
title: "Coins Categories List with Market Data"
method: GET
path: "/coins/categories"
---

# Coins Categories List with Market Data

`GET /coins/categories`

To query all the coins categories with market data (market cap, volume, etc.) on CoinGecko

## Query parameters

- `order` 'market_cap_desc' | 'market_cap_asc' | 'name_desc' | 'name_asc' | 'market_cap_change_24h_desc' | 'market_cap_change_24h_asc'

## Response `200`

List of coin categories with market data

- object[]
  - `id` string, required — Category ID
  - `name` string, required — Category name
  - `market_cap` number, required — Category market cap
  - `market_cap_change_24h` number, required — Category market cap change in 24 hours
  - `content` string, required — Category description
  - `top_3_coins_id` string[], required — IDs of top 3 coins in the category
  - `top_3_coins` string[], required — Image URLs of top 3 coins in the category
  - `volume_24h` number, required — Category trading volume in 24 hours
  - `updated_at` string, required — Category last updated timestamp

## Changes

- **2026-05-28** `11cc9e00fd86` — 10 info
  - api tag `Categories` removed
  - the response property `items/content` became required for the status `200`
  - the response property `items/id` became required for the status `200`
  - the response property `items/market_cap` became required for the status `200`
  - …6 more
- **2026-04-30** `fb6b6a203ce6` — 1 breaking, 9 warning
  - the response's body type/format changed from `object`/`` to `array`/`` for status `200`
  - removed the optional property `content` from the response with the `200` status
  - removed the optional property `id` from the response with the `200` status
  - removed the optional property `market_cap` from the response with the `200` status
  - …6 more

[Change history](https://skmtc.dev/coingecko/apis/coingecko-api/changes/coins/categories/get.md)

---

[API](https://skmtc.dev/coingecko/apis/coingecko-api.md) · [All operations](https://skmtc.dev/coingecko/apis/coingecko-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coingecko/coingecko-api/revisions/006c13c1a566/schema)