> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modulex.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# CoinMarketCap Integration for AI Agents & Workflows

> Cryptocurrency market data, quotes, and metadata from the CoinMarketCap API

{/* Self-hosted logo — build-time vendored from modulex.json / Iconify (see scripts/lib/logo.js). */}

<img className="block dark:hidden" src="https://mintcdn.com/modulexaillc/zKB2qsP6Q61VNLfB/logos/coinmarketcap-light.svg?fit=max&auto=format&n=zKB2qsP6Q61VNLfB&q=85&s=731006882a19efd5d9b77e362b2cd2ec" alt="CoinMarketCap logo" width="72" height="72" data-path="logos/coinmarketcap-light.svg" />

<img className="hidden dark:block" src="https://mintcdn.com/modulexaillc/zKB2qsP6Q61VNLfB/logos/coinmarketcap-dark.svg?fit=max&auto=format&n=zKB2qsP6Q61VNLfB&q=85&s=35ab3636a172ea82a981f327a834a339" alt="CoinMarketCap logo" width="72" height="72" data-path="logos/coinmarketcap-dark.svg" />

## Overview

Add **CoinMarketCap** to any ModuleX agent or workflow. Cryptocurrency market data, quotes, and metadata from the CoinMarketCap REST API (`pro-api.coinmarketcap.com`).

<Info>
  **Categories**: Finance & Payments · Finance · Cryptocurrency · Market Data · **Auth**: API Key · **Actions**: 4
</Info>

## Authentication

### API Key Authentication

Authenticate using your CoinMarketCap API key

<Steps>
  <Step title="Step 1">
    Go to [https://coinmarketcap.com/api/](https://coinmarketcap.com/api/) and sign up for an account
  </Step>

  <Step title="Step 2">
    Navigate to your API dashboard
  </Step>

  <Step title="Step 3">
    Copy your API key
  </Step>

  <Step title="Step 4">
    Paste the API key below
  </Step>
</Steps>

#### Required Credentials

| Field                 | Description                                             | Required | Format                                 |
| --------------------- | ------------------------------------------------------- | -------- | -------------------------------------- |
| CoinMarketCap API Key | Your CoinMarketCap API key from the developer dashboard | Yes      | `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` |

## Available Actions

<AccordionGroup>
  <Accordion title="get_cryptocurrency_metadata — Returns all static metadata available for one or more cryptocurrencies including name, symbol, logo, description, and URLs">
    ### Parameters

    <ResponseField name="ids" type="string" required>
      One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: 1,2,1027
    </ResponseField>

    <ResponseField name="skip_invalid" type="boolean">
      When true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned (Default: `false`)
    </ResponseField>

    <ResponseField name="aux" type="string">
      Comma-separated supplemental data fields to return. Valid values: urls, logo, description, tags, platform, date\_added, notice, status
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "CryptocurrencyMetadata": {
          "additionalProperties": false,
          "description": "Metadata for a single cryptocurrency.",
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "symbol": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Symbol"
            },
            "slug": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Slug"
            },
            "description": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Description"
            },
            "logo": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Logo"
            },
            "date_added": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Added"
            },
            "category": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Category"
            }
          },
          "title": "CryptocurrencyMetadata",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "data": {
          "additionalProperties": {
            "$ref": "#/$defs/CryptocurrencyMetadata"
          },
          "title": "Data",
          "type": "object"
        }
      },
      "required": [
        "success"
      ],
      "title": "GetCryptocurrencyMetadataOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="id_map — Returns a mapping of all cryptocurrencies to unique CoinMarketCap IDs">
    ### Parameters

    <ResponseField name="listing_status" type="string">
      Filter by status. Valid values: active, inactive, untracked. Comma-separated for multiple.
    </ResponseField>

    <ResponseField name="start" type="integer">
      Offset the start (1-based index) of the paginated list of items to return
    </ResponseField>

    <ResponseField name="limit" type="integer">
      Number of results to return. Default 100 (Default: `100`)
    </ResponseField>

    <ResponseField name="sort" type="string">
      Sort field. Valid values: cmc\_rank, id
    </ResponseField>

    <ResponseField name="symbol" type="string">
      Comma-separated list of cryptocurrency symbols to return IDs for. If passed, other options are ignored.
    </ResponseField>

    <ResponseField name="aux" type="string">
      Comma-separated supplemental data fields. Valid values: platform, first\_historical\_data, last\_historical\_data, is\_active, status
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "CryptocurrencyMapItem": {
          "additionalProperties": false,
          "description": "A cryptocurrency mapping entry.",
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "symbol": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Symbol"
            },
            "slug": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Slug"
            },
            "is_active": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Is Active"
            },
            "first_historical_data": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "First Historical Data"
            },
            "last_historical_data": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Last Historical Data"
            }
          },
          "title": "CryptocurrencyMapItem",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "data": {
          "items": {
            "$ref": "#/$defs/CryptocurrencyMapItem"
          },
          "title": "Data",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "IdMapOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="latest_listings — Returns a paginated list of all active cryptocurrencies with latest market data">
    ### Parameters

    <ResponseField name="start" type="integer">
      Offset the start (1-based index) of the paginated list of items to return
    </ResponseField>

    <ResponseField name="limit" type="integer">
      Number of results to return
    </ResponseField>

    <ResponseField name="volume_24h_min" type="number">
      Minimum 24 hour USD volume to filter results by
    </ResponseField>

    <ResponseField name="convert" type="string">
      Comma-separated list of cryptocurrency or fiat currency symbols to calculate market quotes in
    </ResponseField>

    <ResponseField name="convert_id" type="string">
      Comma-separated CoinMarketCap IDs to calculate market quotes in. Cannot be used with convert.
    </ResponseField>

    <ResponseField name="sort" type="string">
      Sort field. Valid values: market\_cap, name, symbol, date\_added, price, circulating\_supply, total\_supply, max\_supply, num\_market\_pairs, volume\_24h, percent\_change\_1h, percent\_change\_24h, percent\_change\_7d
    </ResponseField>

    <ResponseField name="sort_dir" type="string">
      Sort direction. Valid values: asc, desc
    </ResponseField>

    <ResponseField name="cryptocurrency_type" type="string">
      Type of cryptocurrency to include. Valid values: all, coins, tokens
    </ResponseField>

    <ResponseField name="aux" type="string">
      Comma-separated supplemental data fields. Valid values: num\_market\_pairs, cmc\_rank, date\_added, tags, platform, max\_supply, circulating\_supply, total\_supply
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "ListingItem": {
          "additionalProperties": false,
          "description": "A cryptocurrency listing entry with market data.",
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "symbol": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Symbol"
            },
            "slug": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Slug"
            },
            "cmc_rank": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Cmc Rank"
            },
            "circulating_supply": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Circulating Supply"
            },
            "total_supply": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Total Supply"
            },
            "max_supply": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Max Supply"
            },
            "quote": {
              "additionalProperties": {
                "$ref": "#/$defs/QuoteData"
              },
              "title": "Quote",
              "type": "object"
            }
          },
          "title": "ListingItem",
          "type": "object"
        },
        "QuoteData": {
          "additionalProperties": false,
          "description": "Quote data for a single currency conversion.",
          "properties": {
            "price": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Price"
            },
            "volume_24h": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Volume 24H"
            },
            "market_cap": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Market Cap"
            },
            "percent_change_1h": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Percent Change 1H"
            },
            "percent_change_24h": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Percent Change 24H"
            },
            "percent_change_7d": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Percent Change 7D"
            },
            "last_updated": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Last Updated"
            }
          },
          "title": "QuoteData",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "data": {
          "items": {
            "$ref": "#/$defs/ListingItem"
          },
          "title": "Data",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "LatestListingsOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="latest_quotes — Returns the latest market quote for one or more cryptocurrencies. At least one of id, slug, or symbol is required.">
    ### Parameters

    <ResponseField name="id" type="string">
      One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: 1,2
    </ResponseField>

    <ResponseField name="slug" type="string">
      Comma-separated list of cryptocurrency slugs. Example: bitcoin,ethereum
    </ResponseField>

    <ResponseField name="symbol" type="string">
      Comma-separated cryptocurrency symbols. Example: BTC,ETH
    </ResponseField>

    <ResponseField name="convert" type="string">
      Comma-separated list of currency symbols to calculate quotes in
    </ResponseField>

    <ResponseField name="convert_id" type="string">
      Comma-separated CoinMarketCap IDs to calculate quotes in. Cannot be used with convert.
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "CryptocurrencyQuote": {
          "additionalProperties": false,
          "description": "Quote data for a specific cryptocurrency.",
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "symbol": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Symbol"
            },
            "slug": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Slug"
            },
            "cmc_rank": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Cmc Rank"
            },
            "quote": {
              "additionalProperties": {
                "$ref": "#/$defs/QuoteData"
              },
              "title": "Quote",
              "type": "object"
            }
          },
          "title": "CryptocurrencyQuote",
          "type": "object"
        },
        "QuoteData": {
          "additionalProperties": false,
          "description": "Quote data for a single currency conversion.",
          "properties": {
            "price": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Price"
            },
            "volume_24h": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Volume 24H"
            },
            "market_cap": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Market Cap"
            },
            "percent_change_1h": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Percent Change 1H"
            },
            "percent_change_24h": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Percent Change 24H"
            },
            "percent_change_7d": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Percent Change 7D"
            },
            "last_updated": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Last Updated"
            }
          },
          "title": "QuoteData",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "data": {
          "additionalProperties": {
            "$ref": "#/$defs/CryptocurrencyQuote"
          },
          "title": "Data",
          "type": "object"
        }
      },
      "required": [
        "success"
      ],
      "title": "LatestQuotesOutput",
      "type": "object"
    }
    ```
  </Accordion>
</AccordionGroup>

## Limits & Quotas

* **Basic (free) plan**: 333 calls/day, 10,000 calls/month.
* **Hobbyist plan**: 10,000 calls/month.
* **Standard plan and above**: higher limits per the pricing page.
* Rate limiting is applied per API key. Exceeding limits returns HTTP 429.
* **Error model**: non-2xx responses and timeouts are caught and returned as `success=False` + `error` rather than raising.

## Related integrations

<CardGroup cols={3}>
  <Card title="Coinbase" href="/integrations/tools/coinbase" />

  <Card title="Kalshi" href="/integrations/tools/kalshi" />

  <Card title="Lemon Squeezy" href="/integrations/tools/lemon-squeezy" />
</CardGroup>

## Links

* [CoinMarketCap](https://coinmarketcap.com)