Coins Categories List with Market Data

Changed on May 28, 2026

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

get/coins/categories

Request

Base URL
https://pro-api.coingecko.com/api/v3
Auth
- API key in header x-cg-pro-api-key
- or API key in query parameter x_cg_pro_api_key

Query parameters

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

Sort results by field. Default: market_cap_desc

Response

List of coin categories with market data

idstring required

Category ID

namestring required

Category name

market_capnumber required

Category market cap

market_cap_change_24hnumber required

Category market cap change in 24 hours

contentstring required

Category description

top_3_coins_idstring[] required

IDs of top 3 coins in the category

top_3_coinsstring[] required

Image URLs of top 3 coins in the category

volume_24hnumber required

Category trading volume in 24 hours

updated_atstring required

Category last updated timestamp

Changes

May 28, 202611cc9e00fd86 Revision changes
- info
  api tag Categories removed
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
Apr 30, 2026fb6b6a203ce6 Revision changes
- breaking
  the response's body type changed from object to array for status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status

Operation history