CoinMarketCal

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/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

FieldTypeDescription
dataarray<Category>All categories.

◆ Category

FieldTypeDescription
idstringStable category id (kebab-case slug).
namestringDisplay name (e.g. `Release`).
countintegerNumber of upcoming events in this category, scoped to the requester's tier window.

◆ Request

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

◆ Example response

{
  "data": [
    {
      "id": "airdrop-snapshot",
      "name": "Airdrop/Snapshot",
      "count": 156
    },
    {
      "id": "ama-team-update",
      "name": "AMA/Team Update",
      "count": 73
    },
    {
      "id": "branding",
      "name": "Branding",
      "count": 42
    },
    {
      "id": "conference",
      "name": "Conference",
      "count": 61
    },
    {
      "id": "exchange",
      "name": "Exchange",
      "count": 218
    },
    {
      "id": "fork-swap",
      "name": "Fork/Swap",
      "count": 48
    },
    {
      "id": "integration",
      "name": "Integration",
      "count": 264
    },
    {
      "id": "partnership",
      "name": "Partnership",
      "count": 284
    },
    {
      "id": "regulation",
      "name": "Regulation",
      "count": 184
    },
    {
      "id": "release",
      "name": "Release",
      "count": 319
    },
    {
      "id": "staking-farming",
      "name": "Staking/Farming",
      "count": 137
    },
    {
      "id": "tokenomics",
      "name": "Tokenomics",
      "count": 205
    },
    {
      "id": "other",
      "name": "Other",
      "count": 89
    }
  ]
}

◆ Try it

Loading your keys…

No parameters. Sends straight to the API.

→ https://api.coinmarketcal.com/v2/categories