CoinMarketCal API

openapi: 3.1.0
info:
  title: CoinMarketCal API
  version: '2026-11-04'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-04: 9 operation(s) read from 8 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; CoinMarketCal has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 8
    pages-with-code: 5
    pages-read: 8
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-04'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://coinmarketcal.com/developer
  - https://coinmarketcal.com/developer/docs
  - https://coinmarketcal.com/developer/docs/webhooks
  - https://coinmarketcal.com/developer/docs/openapi.json
  - https://coinmarketcal.com/developer/docs/mcp
  - https://coinmarketcal.com/developer/docs/coins
  - https://coinmarketcal.com/developer/docs/usage
  - https://coinmarketcal.com/developer/docs/events
servers:
- url: https://api.coinmarketcal.com
paths:
  /v2:
    get:
      operationId: get_v2
      tags:
      - Api
      summary: MCP Server · CoinMarketCal
      x-source: https://coinmarketcal.com/developer/docs/mcp
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/categories:
    get:
      operationId: get_v2_categories
      tags:
      - Categories
      summary: List categories
      x-source: https://coinmarketcal.com/developer/docs/mcp
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/coins:
    get:
      operationId: get_v2_coins
      tags:
      - Coins
      summary: Returns a paginated list of coins ordered by rank ascending (top‑ranked first).
      description: Provides coin listings with optional tracking filter; results are paginated.
      x-source: https://coinmarketcal.com/developer
      parameters:
      - name: tracked
        in: query
        required: false
        schema:
          type: string
        description: Filter to limit results by editorial coverage.
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Maximum number of coins to return per page.
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        description: Pagination cursor for subsequent pages.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV2CoinsResponse'
      x-evidence:
        kind: documentation
  /v2/coins/{slug}:
    get:
      operationId: get_v2_coins_slug
      tags:
      - Coins
      summary: Fetch a single coin
      x-source: https://coinmarketcal.com/developer/docs/mcp
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/events:
    get:
      operationId: get_v2_events
      tags:
      - Events
      summary: GET /v2/events
      x-source: https://coinmarketcal.com/developer
      parameters:
      - name: from
        in: query
        required: false
        schema:
          type: string
      - name: impactMin
        in: query
        required: false
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: string
      - name: sortBy
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV2EventsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl JavaScript Copy curl -X GET \"https://api.coinmarketcal.com/v2/events?from=2017-01-01&impactMin=7.5&sortBy=date_asc&limit=100\"\
          \  -H \"x-api-key: $COINMARKETCAL_API_KEY\"  -H \"Accept: application/json\" → 200 OK { \n \"data\" : [ \n { \n \"id\" : \"48291\" ,\
          \ \n \"title\" : \"Ethereum Pectra Upgrade\" , \n \"displayedDate\" : \"06 May 2026\" , \n \"categories\" : [ \n \"Release\" \n ] ,\
          \ \n \"coins\" : [ \n { \n \"slug\" : \"ethereum"
  /v2/events/{id}:
    get:
      operationId: get_v2_events_id
      tags:
      - Events
      summary: Returns the full event payload by id.
      description: Returns detailed information for a specific event; tier‑gated fields depend on the caller's plan.
      x-source: https://coinmarketcal.com/developer
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV2EventsIdResponse'
      x-evidence:
        kind: documentation
  /v2/exports/events.csv:
    get:
      operationId: get_v2_exports_events_csv
      tags:
      - Exports
      summary: Export an event date range
      description: Exports an inclusive event‑date range; Elite+ tier only.
      x-source: https://coinmarketcal.com/developer/docs/events
      parameters:
      - name: from
        in: query
        required: true
        schema:
          type: string
        description: Start of the inclusive event‑date range (ISO‑8601).
      - name: to
        in: query
        required: true
        schema:
          type: string
        description: End of the inclusive event‑date range (ISO‑8601).
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV2ExportsEventsCsvResponse'
      x-evidence:
        kind: documentation
  /v2/exports/events/snapshot:
    get:
      operationId: get_v2_exports_events_snapshot
      tags:
      - Exports
      summary: Get the current full‑catalog snapshot
      description: Returns the complete catalog through a private CSV.GZ URL; Elite+ tier only.
      x-source: https://coinmarketcal.com/developer/docs/events
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV2ExportsEventsSnapshotResponse'
      x-evidence:
        kind: documentation
  /v2/usage:
    get:
      operationId: get_v2_usage
      tags:
      - Usage
      summary: Monthly usage
      x-source: https://coinmarketcal.com/developer/docs/mcp
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    GetV2CoinsResponse:
      type: object
      properties:
        data:
          type: array
          description: List of coin objects.
        meta:
          type: object
          description: Pagination metadata (total, limit, cursor).
    GetV2EventsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              title:
                type: string
              displayedDate:
                type: string
              categories:
                type: array
                items:
                  type: string
              coins:
                type: array
                items:
                  type: object
                  properties:
                    slug:
                      type: string
                    symbol:
                      type: string
                    name:
                      type: string
              impact:
                type: number
        meta:
          type: object
          properties:
            total:
              type: integer
            limit:
              type: integer
            cursor:
              type: string
    GetV2EventsIdResponse:
      type: object
      properties:
        id:
          type: string
          description: Event identifier.
        title:
          type: string
          description: Event title.
        displayedDate:
          type: string
          description: Human‑readable event date.
        categories:
          type: array
          description: Event categories.
        coins:
          type: array
          description: Associated coins (slug, symbol, name).
        impact:
          type: number
          description: Impact score.
    GetV2ExportsEventsCsvResponse:
      type: object
      properties:
        file:
          type: string
          description: CSV file containing the exported events (max 4 MiB).
    GetV2ExportsEventsSnapshotResponse:
      type: object
      properties:
        url:
          type: string
          description: Private CSV.GZ URL valid for 15 minutes.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
security:
- apiKey: []
tags:
- name: Api
- name: Categories
- name: Coins
- name: Events
- name: Exports
- name: Usage