Skip to main content
CoinMarketCap logo

​
Overview

Add CoinMarketCap to any ModuleX agent or workflow. Cryptocurrency market data, quotes, and metadata from the CoinMarketCap REST API (pro-api.coinmarketcap.com).
Categories: Finance & Payments · Finance · Cryptocurrency · Market Data · Auth: API Key · Actions: 4

​
Authentication

​
API Key Authentication

Authenticate using your CoinMarketCap API key
1

Step 1

Go to https://coinmarketcap.com/api/ and sign up for an account
2

Step 2

Navigate to your API dashboard
3

Step 3

Copy your API key
4

Step 4

Paste the API key below

​
Required Credentials

FieldDescriptionRequiredFormat
CoinMarketCap API KeyYour CoinMarketCap API key from the developer dashboardYesxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

​
Available Actions

​
Parameters

​
ids
string
required
One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: 1,2,1027
​
skip_invalid
boolean
When true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned (Default: false)
​
aux
string
Comma-separated supplemental data fields to return. Valid values: urls, logo, description, tags, platform, date_added, notice, status

​
Response

{
  "$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"
}

​
Parameters

​
listing_status
string
Filter by status. Valid values: active, inactive, untracked. Comma-separated for multiple.
​
start
integer
Offset the start (1-based index) of the paginated list of items to return
​
limit
integer
Number of results to return. Default 100 (Default: 100)
​
sort
string
Sort field. Valid values: cmc_rank, id
​
symbol
string
Comma-separated list of cryptocurrency symbols to return IDs for. If passed, other options are ignored.
​
aux
string
Comma-separated supplemental data fields. Valid values: platform, first_historical_data, last_historical_data, is_active, status

​
Response

{
  "$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"
}

​
Parameters

​
start
integer
Offset the start (1-based index) of the paginated list of items to return
​
limit
integer
Number of results to return
​
volume_24h_min
number
Minimum 24 hour USD volume to filter results by
​
convert
string
Comma-separated list of cryptocurrency or fiat currency symbols to calculate market quotes in
​
convert_id
string
Comma-separated CoinMarketCap IDs to calculate market quotes in. Cannot be used with convert.
​
sort
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
​
sort_dir
string
Sort direction. Valid values: asc, desc
​
cryptocurrency_type
string
Type of cryptocurrency to include. Valid values: all, coins, tokens
​
aux
string
Comma-separated supplemental data fields. Valid values: num_market_pairs, cmc_rank, date_added, tags, platform, max_supply, circulating_supply, total_supply

​
Response

{
  "$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"
}

​
Parameters

​
id
string
One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: 1,2
​
slug
string
Comma-separated list of cryptocurrency slugs. Example: bitcoin,ethereum
​
symbol
string
Comma-separated cryptocurrency symbols. Example: BTC,ETH
​
convert
string
Comma-separated list of currency symbols to calculate quotes in
​
convert_id
string
Comma-separated CoinMarketCap IDs to calculate quotes in. Cannot be used with convert.

​
Response

{
  "$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"
}

​
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.

Coinbase

Kalshi

Lemon Squeezy