Exports

Bulk-download the full event catalog as a CSV. Available at the Elite tier and above. Returns a text/csv body; pipe it directly to disk or your warehouse loader. The export reflects the same filters / tier window as GET /v2/events and ignores pagination.

◆ Endpoints

GET/v2/exports/events.csvDownload events as CSV

GET/v2/exports/events.csvElite+

Download events as CSV

Returns one row per event. Date columns are ISO-8601 (UTC). List columns (coins, categories) are pipe-separated (BTC|ETH); pipe characters inside any value are doubled (||) so the format is always parseable. Unknown / null values render as empty cells, NOT the literal null. The header row is the first line. UTF-8 encoded.

Columns (in order): id, slug, title, date, dateEnd, dateType, isEstimated, displayedDate, categories, coins, impact, impactSummary, sourceUrl, snapshotUrl, lastVerifiedAt, createdAt, updatedAt. Tier-gated columns (impact / sourceUrl / snapshotUrl / impactSummary / lastVerifiedAt) render empty on tiers that don't include them.

Size: a full snapshot is typically 5–20 MB and may take up to a minute to stream; set your loader timeout to at least 60 s. The endpoint is rate-limited separately from the JSON API (1 req/min on Elite). See Rate limits.

◆ Parameters

Field	In	Type	Required	Description
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.

◆ Response

Field	Type	Description
—	string	`text/csv` body with a header row. UTF-8 encoded.

◆ Request

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

◆ Example response

id,slug,title,date,coins,impact
evt_2026_05_06_eth_pectra,ethereum-pectra-upgrade,"Ethereum Pectra Upgrade",2026-05-06T12:00:00Z,ETH,8.5