Migrate from API V1 to V2

API V1 was retired on July 14, 2026 and no longer returns data. Follow these steps to move your integration to V2.

◆ Move to V2

1. Create a V2 account on the developer portal.
2. Open API keys and copy your key.
3. Replace your V1 base URL with https://api.coinmarketcal.com/v2.
4. Check the V2 endpoint, query parameters, and response fields used by your integration.

◆ Main differences

• Use your new V2 key with the same x-api-key header.
• Event results moved from body to data.
• Cursor pagination is returned in meta.cursor.

Endpoint coverage

Common event query changes

• max → limit
• page → cursor
• dateRangeStart / dateRangeEnd → from / to
• id query parameter → GET /events/{id}
• V1 filters exchanges, showOnly, showVotes, showViews, and translations have no direct V2 equivalent.

V2 also adds GET /events/cancellations, GET /usage, and Elite+ webhooks managed in the developer dashboard.

◆ Before and after

# V1 — retired
curl -H "x-api-key: $CMC_API_V1_KEY" \
  "https://developers.coinmarketcal.com/v1/events?coins=ethereum&max=1"

◆ Display event dates correctly

Replace body[0].displayed_date with data[0].displayedDate.

{
  "date": "2026-06-30T23:59:59Z",
  "dateType": "quarter",
  "isEstimated": true,
  "displayedDate": "Q2 2026"
}

Always display displayedDate to users. When isEstimated is true, date represents a deadline or window boundary, not an exact event date.

◆ Need help?

Check the V2 API documentation or email [email protected].

Paid V1 subscriptions are refunded pro rata from July 14, 2026.