# CoinMarketCap

CoinMarketCap provides a comprehensive cryptocurrency market data API, offering real-time and historical data on cryptocurrencies and exchanges.

- **Category:** analytics
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 9
- **Triggers:** 0
- **Slug:** `COINMARKETCAP`
- **Version:** 20260316_00

## Tools

### Cryptocurrency Listings Latest

**Slug:** `COINMARKETCAP_CRYPTOCURRENCY_LISTINGS_LATEST`

Fetch the latest cryptocurrency market listings from CoinMarketCap. Returns a ranked list of active cryptocurrencies with real-time price, market cap, 24h volume, and percent changes. By default returns top 100 by market cap. Common use cases: - Get top cryptocurrencies: No params needed (defaults to top 100 by market cap) - Find DeFi tokens: tag="defi" - Get high volume assets: volume_24h_min=1000000000 - Find cheap small caps: price_max=1, market_cap_max=10000000 - Get biggest gainers: sort="percent_change_24h", sort_dir="desc" - Pagination: Use start and limit (e.g., start=101, limit=100 for page 2)

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `aux` | string | No | Customize response fields. If set, only specified aux fields are returned. Common values: num_market_pairs,cmc_rank,date_added,tags,platform,max_supply,circulating_supply,total_supply |
| `tag` | string | No | Filter by tag (e.g., 'defi', 'stablecoin', 'layer-1', 'memes'). Use comma for multiple. |
| `sort` | string ("market_cap" | "price" | "volume_24h" | "percent_change_24h" | "name") | No | Sort field. Default: market_cap. Options: market_cap, price, volume_24h, percent_change_24h, name |
| `limit` | integer | No | Number of results to return (1-5000). Default: 100. Use with 'start' for pagination. |
| `start` | integer | No | 1-based pagination offset (e.g., start=101 to skip first 100 results). Default: 1 |
| `convert` | string | No | Quote currency symbol (e.g., 'USD', 'EUR', 'BTC'). Default: USD. Note: API plan may limit to 1 convert option. |
| `sort_dir` | string ("asc" | "desc") | No | Sort direction. Default: desc (highest first). Use 'asc' for lowest first. |
| `price_max` | number | No | Filter: maximum USD price. Example: 100 to find assets under $100. |
| `price_min` | number | No | Filter: minimum USD price. Example: 0.01 to exclude very cheap assets. |
| `convert_id` | string | No | Alternative to 'convert': CoinMarketCap ID of quote currency (e.g., '2781' for USD, '1' for BTC) |
| `market_cap_max` | number | No | Filter: maximum market cap in USD. Example: 10000000 for small caps under $10M. |
| `market_cap_min` | number | No | Filter: minimum market cap in USD. Example: 1000000000 for $1B+ market cap. |
| `volume_24h_max` | number | No | Filter: maximum 24h trading volume in USD. |
| `volume_24h_min` | number | No | Filter: minimum 24h trading volume in USD. Example: 1000000 for $1M+ daily volume. |
| `cryptocurrency_type` | string ("all" | "coins" | "tokens") | No | Filter by asset type. 'coins' = native coins like BTC/ETH, 'tokens' = tokens on other platforms, 'all' = both. Default: all |
| `circulating_supply_max` | number | No | Filter: maximum circulating supply (number of coins/tokens). |
| `circulating_supply_min` | number | No | Filter: minimum circulating supply (number of coins/tokens). |
| `percent_change_24h_max` | number | No | Filter: maximum 24h price change percentage. Example: 50 to exclude extreme gainers. |
| `percent_change_24h_min` | number | No | Filter: minimum 24h price change percentage. Example: -10 to exclude assets down more than 10%. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cryptocurrency Map

**Slug:** `COINMARKETCAP_CRYPTOCURRENCY_MAP`

Tool to retrieve a mapping of all cryptocurrencies, including their unique IDs, symbols, and names. Use when you need reference IDs for crypto assets. Response results are nested under a `data` key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Comma-separated CoinMarketCap IDs to filter, e.g., '1,1027'. Note: This parameter may require a paid API plan. |
| `aux` | string | No | Comma-separated additional fields to include: platform, first_historical_data, last_historical_data, is_active. Only the listed values are valid; unsupported values trigger HTTP 400. |
| `slug` | string | No | Comma-separated URL slugs to filter, e.g., 'bitcoin,ethereum'. |
| `sort` | string ("id" | "cmc_rank") | No | Field to sort by: 'id' or 'cmc_rank'. |
| `limit` | integer | No | Number of results to return, between 1 and 5000. |
| `start` | integer | No | 1-based index of the first item to return. |
| `symbol` | string | No | Comma-separated cryptocurrency symbols to filter, e.g., 'BTC,ETH'. A single symbol can map to multiple cryptocurrencies (including inactive ones); use `listing_status=active` and prefer the lowest `cmc_rank` value to identify the intended asset. |
| `listing_status` | string | No | Comma-separated list of statuses to include: active, inactive, untracked. Defaults to 'active'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Latest Cryptocurrency Quotes

**Slug:** `COINMARKETCAP_CRYPTOCURRENCY_QUOTES_LATEST`

Tool to get the latest aggregated global market quotes for one or more cryptocurrencies. Exactly one of id, symbol, or slug must be provided; combining multiple identifier types or omitting all causes an error. Response is nested under data → SYMBOL (or ID) → quote → TARGET_CURRENCY for fields like price and last_updated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Comma-separated CoinMarketCap cryptocurrency IDs. Provide this or symbol or slug. Limit batches to ~100 IDs per call. |
| `aux` | string | No | Comma-separated list of auxiliary data fields to include. Available: num_market_pairs, cmc_rank, date_added, tags, platform, max_supply, circulating_supply, total_supply, is_active, is_fiat. Defaults to including all if not specified. Unsupported field names trigger a 400 error. |
| `slug` | string | No | Comma-separated cryptocurrency slugs. Provide this or id or symbol. |
| `symbol` | string | No | Comma-separated cryptocurrency symbols. Provide this or id or slug. |
| `convert` | string | No | Fiat or cryptocurrency symbol to convert values into. Cannot be used with convert_id. |
| `convert_id` | string | No | Comma-separated CoinMarketCap IDs for conversion currencies. Cannot be used with convert. |
| `skip_invalid` | boolean | No | If true, invalid symbols/IDs are silently skipped by the API. If false, the API returns a 400 error for any invalid symbol/ID. Defaults to true to prevent failures when exact symbols are uncertain. Always verify expected assets appear in the response before reading prices, as dropped identifiers are absent from the returned data without warning. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get cryptocurrency info

**Slug:** `COINMARKETCAP_GET_CRYPTOCURRENCY_INFO`

Tool to fetch metadata (description, logo, URLs) for one or more cryptocurrencies. Use when you need static asset details like descriptions, logos, and related links. Exactly one of `id`, `slug`, or `symbol` must be provided; combining multiple lookup parameters causes errors. Response is nested under a `data` object keyed by asset ID or symbol.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | array | No | List of CoinMarketCap cryptocurrency IDs. Required if `slug` and `symbol` are not provided. |
| `slug` | array | No | List of cryptocurrency slugs (e.g., ['bitcoin', 'ethereum']). Required if `id` and `symbol` are not provided. |
| `symbol` | array | No | List of cryptocurrency symbols (e.g., ['BTC', 'ETH']). Required if `id` and `slug` are not provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get exchange info

**Slug:** `COINMARKETCAP_GET_EXCHANGE_INFO`

Tool to get detailed metadata for one or more exchanges. Use when you need exchange logos, supported fiats, launch dates, and official links.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | array | No | List of CoinMarketCap exchange IDs. Required if `slug` is not provided. |
| `aux` | string | No | Comma-separated list of additional metadata fields to include: logo, description, date_launched, notice, countries, fiats, urls. |
| `slug` | array | No | List of exchange slugs (e.g., ['binance', 'kraken']). Required if `id` is not provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get API Key Info

**Slug:** `COINMARKETCAP_GET_KEY_INFO`

Tool to retrieve your CoinMarketCap API key details, rate limits, and usage statistics. Use after setting your API key to inspect limits and usage.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Global Metrics Quotes Latest

**Slug:** `COINMARKETCAP_GLOBAL_METRICS_QUOTES_LATEST`

Tool to obtain the latest global cryptocurrency market metrics (market cap, volume, dominance). Use when you need aggregated market-level data for analysis.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `convert` | string | No | Currency symbol to convert market quotes into (e.g., 'USD', 'BTC', 'EUR'). Defaults to USD if not specified. Note: Basic API plans are limited to 1 conversion currency. |
| `convert_id` | string | No | CoinMarketCap cryptocurrency ID to use for quote conversion instead of symbol (e.g., '1' for Bitcoin, '1027' for Ethereum). Use this as an alternative to 'convert' when you have the CMC ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Partner Map

**Slug:** `COINMARKETCAP_PARTNER_MAP`

Tool to retrieve a mapping of all CoinMarketCap partners with their unique IDs, names, and slugs. Use when you need to map partner names or slugs to numeric IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `slug` | string | No | Comma-separated slugs to filter. Example: 'binance,gdax' |
| `limit` | integer | No | Number of results to return (1-5000). |
| `start` | integer | No | 1-based index of the first item to return for pagination. |
| `listing_status` | string | No | Filter by listing status. Example: 'active', 'inactive', 'untracked'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Price Conversion

**Slug:** `COINMARKETCAP_TOOLS_PRICE_CONVERSION`

Tool to convert an amount from one cryptocurrency or fiat currency into another. Either `id` or `symbol` must be provided as the source currency identifier. Use when conversion rates are needed. Unsupported currency symbols or IDs will cause validation errors.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | CoinMarketCap ID of the source currency. Use this or 'symbol'. Example: 1 for Bitcoin, 1027 for Ethereum, 2781 for USD. |
| `time` | string | No | Optional timestamp for historical conversion. Use ISO 8601 format (e.g., '2024-01-01T00:00:00Z') or 'YYYY-MM-DD'. Omit for current rates. |
| `amount` | number | Yes | Amount of the cryptocurrency or fiat currency to convert. Must be >= 1e-8. |
| `symbol` | string | No | Ticker symbol of the source currency (e.g., 'BTC', 'ETH', 'USD'). Use this or 'id'. Case-insensitive. |
| `convert` | string | No | Target currency symbol to convert to (e.g., 'USD', 'EUR', 'BTC'). Defaults to USD if omitted. Use 'convert' or 'convert_id', not both. |
| `convert_id` | string | No | CoinMarketCap ID of the target currency (e.g., '2781' for USD). Use 'convert' or 'convert_id', not both. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |