Skip to main content
GET
/
coins
/
categories
Coins Categories List with Market Data
curl --request GET \
  --url https://api.coingecko.com/api/v3/coins/categories \
  --header 'x-cg-demo-api-key: <api-key>'
[
  {
    "id": "layer-1",
    "name": "Layer 1 (L1)",
    "market_cap": 2061406861196.14,
    "market_cap_change_24h": -0.66091235190398,
    "content": "",
    "top_3_coins_id": [
      "bitcoin",
      "ethereum",
      "binancecoin"
    ],
    "top_3_coins": [
      "https://assets.coingecko.com/coins/images/1/small/bitcoin.png?1696501400",
      "https://assets.coingecko.com/coins/images/279/small/ethereum.png?1696501628",
      "https://assets.coingecko.com/coins/images/825/small/bnb-icon2_2x.png?1696501970"
    ],
    "volume_24h": 61146432400.1739,
    "updated_at": "2024-04-06T08:25:46.402Z"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Tips

  • To retrieve a list of coins for a specific category, use the /coins/markets endpoint and provide the category ID via the category parameter.

​
Note

Authorizations

​
x-cg-demo-api-key
string
header
required

Query Parameters

​
order
enum<string>

sort results by field, default: market_cap_desc

Available options:
market_cap_desc,
market_cap_asc,
name_desc,
name_asc,
market_cap_change_24h_desc,
market_cap_change_24h_asc

Response

200 - application/json

List all categories with market data

​
id
string

category ID

​
name
string

category name

​
market_cap
number

category market cap

​
market_cap_change_24h
number

category market cap change in 24 hours

​
content
string

category description

​
top_3_coins_id
string[]

IDs of top 3 coins in the category

​
top_3_coins
string[]

images of top 3 coins in the category

​
volume_24h
number

category volume in 24 hours

​
updated_at
string

category last updated time