CoinMarketCap Integration

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

get_cryptocurrency_metadata — Returns all static metadata available for one or more cryptocurrencies including name, symbol, logo, description, and URLs

Parameters

string

required

One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: 1,2,1027

boolean

When true, invalid lookups will be skipped allowing valid cryptocurrencies to still be returned (Default: false)

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

id_map — Returns a mapping of all cryptocurrencies to unique CoinMarketCap IDs

Parameters

string

Filter by status. Valid values: active, inactive, untracked. Comma-separated for multiple.

integer

Offset the start (1-based index) of the paginated list of items to return

integer

Number of results to return. Default 100 (Default: 100)

string

Sort field. Valid values: cmc_rank, id

string

Comma-separated list of cryptocurrency symbols to return IDs for. If passed, other options are ignored.

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

latest_listings — Returns a paginated list of all active cryptocurrencies with latest market data

Parameters

integer

Offset the start (1-based index) of the paginated list of items to return

integer

Number of results to return

number

Minimum 24 hour USD volume to filter results by

string

Comma-separated list of cryptocurrency or fiat currency symbols to calculate market quotes in

string

Comma-separated CoinMarketCap IDs to calculate market quotes in. Cannot be used with convert.

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

string

Sort direction. Valid values: asc, desc

string

Type of cryptocurrency to include. Valid values: all, coins, tokens

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

latest_quotes — Returns the latest market quote for one or more cryptocurrencies. At least one of id, slug, or symbol is required.

Parameters

string

One or more comma-separated CoinMarketCap cryptocurrency IDs. Example: 1,2

string

Comma-separated list of cryptocurrency slugs. Example: bitcoin,ethereum

string

Comma-separated cryptocurrency symbols. Example: BTC,ETH

string

Comma-separated list of currency symbols to calculate quotes in

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

Using

Providers

Building

Tools

CoinMarketCap Integration for AI Agents & Workflows

Overview

Authentication

API Key Authentication

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Coinbase

Kalshi

Lemon Squeezy

Links

​Overview

​Authentication

​API Key Authentication

​Required Credentials

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

Coinbase

Kalshi

Lemon Squeezy

​Links

Overview

Authentication

API Key Authentication

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links