Events

Read curated, scored crypto events. Filter by coin, category, date range, or impact. Every event has an editorial title, date, linked coins, and (on Pro+) source proof and an impact score.

◆ Endpoints

GET/v2/eventsList events
GET/v2/events/{id}Fetch a single event

GET/v2/events

List events

Returns a paginated list of upcoming events. Default sort is date asc (soonest first). The coins, categories, and date filters compose with AND.

◆ Parameters

Field	In	Type	Required	Description
coins	query	string	no	Comma-separated coin slugs (e.g. `bitcoin,ethereum`). Tickers are accepted but strongly discouraged; symbols collide across coins (e.g. `UNI` resolves to several different projects). Use `GET /v2/coins` to look up canonical slugs.
categories	query	string	no	Comma-separated category ids. Case-insensitive. Use `GET /v2/categories` to look up the canonical id list.
from	query	iso8601	no	Inclusive lower bound on `date`. Default = today.
to	query	iso8601	no	Inclusive upper bound on `date`. Default = today + tier upcoming window (e.g. 7 days on Free, 90 days on Standard, full on Pro+).
keyword	query	string	no	Free-text search across event title and description. Case-insensitive substring match.
impactMin	query	number	no	Lower bound on impact score (0.0–10.0). Pro+ only; ignored on Standard.
sortBy	query	string	no	Sort order. Default `date_asc` (soonest first).Default `date_asc`·Enum: `date_asc` · `date_desc` · `created_desc` · `created_desc_and_updated_desc` · `impact_desc`
limit	query	integer	no	Page size (1–100).Default `20`
cursor	query	string	no	Opaque pagination cursor returned in the previous response's `meta.cursor`.

◆ Response item

Field	Type	Description
id	string	Stable event identifier.
slug	string	URL-safe slug used on the public site.
title	string	Editorial title: neutral, factual, no marketing copy.
description	string	One-paragraph summary of what the event is and what's at stake.
date	iso8601	Event start date in ISO-8601. Do NOT render this directly when `isEstimated` is true (see below). Use it for sorting / filtering / machine logic.
dateEnd	iso8601	Range end date. Empty string on single-day events. Non-empty marks this as a multi-day window.
dateType	string	One of `date` · `month` · `quarter`. Indicates how the date was sourced. Range events use `date` with a non-empty `dateEnd`. Drives display reconstruction when `isEstimated` is true.
isEstimated	boolean	True when the date is a hedge or a window-end. `month` / `quarter` events auto-imply true; for `date` it depends on the source's wording (e.g. "around 15 May", "expected by Q2"). When true, treat `date` as imprecise and use `displayedDate` to render to users.
displayedDate	string	Pre-formatted human-readable date string (e.g. `Q2 2026`, `By 30 May`, `Aug 2026`, `01 Jun → 03 Jun`). Use this on user-facing UI; fall back to constructing your own from `dateType` + `date` + `dateEnd` + `isEstimated` only if you need a different format.
categories	string[]	Editorial categories from the canonical taxonomy (e.g. `Release`, `Regulation`, `Fork/Swap`).
coins	array<CoinRef>	Coins linked to this event.
impact	string	Editorial impact. `null` on Free / Standard. On Pro, one of `Low` · `Mid` · `High` · `Critical`. On Elite+, a precise score 0.0–10.0 (returned as a JSON number).
impactSummary	string	One-sentence editorial summary for the impact score (Pro+).
sourceUrl	string	URL of the original announcement (Pro+).
snapshotUrl	string	Screenshot proof of the source at the time of curation (Pro+).
lastVerifiedAt	iso8601	When editorial last re-verified this event (Pro+).
createdAt	iso8601	When the event was first added to the catalog.
updatedAt	iso8601	When the event was last modified.

◆ CoinRef

Field	Type	Description
slug	string	Stable coin identifier. URL-safe; never changes.
symbol	string	Trading ticker.
name	string	Display name (e.g. `Bitcoin`).

◆ PaginationMeta

Field	Type	Description
total	integer	Total number of records matching the filters.
limit	integer	Page size that was applied.
cursor	string	Opaque cursor; pass to the next request as `cursor` to fetch the next page. Null on the last page.

◆ List wrapper

Field	Type	Description
data	array<Event>	Page of events.
meta	object<PaginationMeta>	Pagination metadata.

◆ Request

curl -X GET "https://api.coinmarketcal.com/v2/events?impactMin=7.5" \
  -H "x-api-key: $COINMARKETCAL_API_KEY" \
  -H "Accept: application/json"

◆ Example response

{
  "data": [
    {
      "id": "48291",
      "slug": "ethereum-pectra-upgrade",
      "title": "Ethereum Pectra Upgrade",
      "description": "The Pectra upgrade activates on Ethereum mainnet, bundling EIP-7702 account abstraction, validator-consolidation changes, and increased blob throughput for rollups.",
      "date": "2026-05-06T12:00:00Z",
      "dateEnd": "",
      "dateType": "date",
      "isEstimated": false,
      "displayedDate": "06 May 2026",
      "categories": [
        "Release"
      ],
      "coins": [
        {
          "slug": "ethereum",
          "symbol": "ETH",
          "name": "Ethereum"
        }
      ],
      "impact": 8.5,
      "impactSummary": "Pectra directly touches wallet UX, rollup economics, and validator income across the Ethereum ecosystem.",
      "sourceUrl": "https://blog.ethereum.org/2026/02/12/pectra-mainnet-activation",
      "snapshotUrl": "https://d32bfp67k1q0s7.cloudfront.net/eth-pectra.png",
      "lastVerifiedAt": "2026-04-19T09:00:00Z",
      "createdAt": "2026-02-12T14:22:00Z",
      "updatedAt": "2026-04-19T09:00:00Z"
    }
  ],
  "meta": {
    "total": 1247,
    "limit": 20,
    "cursor": "eyJvZmZzZXQiOjIwfQ"
  }
}

◆ Try it

API keysent as `x-api-key` · saved locally

Loading your keys…

coinsquery · stringcategoriesquery · stringfromquery · iso8601toquery · iso8601keywordquery · stringimpactMinquery · numbersortByquery · stringlimitquery · integercursorquery · string

Live request. Counts against your plan's rate limit.

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

GET/v2/events/{id}

Fetch a single event

Returns the full event payload by id. Tier-gated fields (impact score, source proof) follow the caller's plan. The same tier date window as GET /v2/events applies — an event outside your plan window returns 404 even when the id exists.