Categories

Read the closed list of editorial categories used to tag events. Use the id returned here as the canonical value when filtering events via GET /v2/events?categories=.... The list is short and rarely changes. Cache for 24 h.

◆ Endpoints

GET/v2/categoriesList categories

GET/v2/categories

List categories

Returns every category in the editorial taxonomy with the count of upcoming events per category (tier-windowed). Not paginated; the full list always fits in one response.

◆ Parameters

No parameters.

◆ Response

Field	Type	Description
data	array<Category>	All categories.

◆ Category

Field	Type	Description
id	string	Stable category id (kebab-case slug).
name	string	Display name (e.g. `Release`).
count	integer	Number of upcoming events in this category, scoped to the requester's tier window.

◆ Request

curl -X GET "https://api.coinmarketcal.com/v2/categories" \
  -H "Authorization: Bearer $COINMARKETCAL_API_KEY" \
  -H "Accept: application/json"

◆ Try it

Preview mode. Sample response only — no live API request.

Documentation preview. Send builds the URL from the fields and shows a sample response from the OpenAPI docs — no HTTP request to the public API. Loading a key from the menu only calls /api/developer/keys (session).

API key — optional · not sent in preview mode

Loading your keys…

Builds the sample request URL · example response.