Skip to main content
CoinMarketCap logo
  • Category: analytics
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 9
  • Triggers: 0
  • Slug: COINMARKETCAP
  • Version: 20261101_00

Tools

Slug: COINMARKETCAP_CRYPTOCURRENCY_LISTINGS_LATESTFetch 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

string
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
string
Filter by tag (e.g., ‘defi’, ‘stablecoin’, ‘layer-1’, ‘memes’). Use comma for multiple.
string ("market_cap" | "price" | "volume_24h" | "percent_change_24h" | "name")
Sort field. Default: market_cap. Options: market_cap, price, volume_24h, percent_change_24h, name
integer
Number of results to return (1-5000). Default: 100. Use with ‘start’ for pagination.
integer
1-based pagination offset (e.g., start=101 to skip first 100 results). Default: 1
string
Quote currency symbol (e.g., ‘USD’, ‘EUR’, ‘BTC’). Default: USD. Note: API plan may limit to 1 convert option.
string ("asc" | "desc")
Sort direction. Default: desc (highest first). Use ‘asc’ for lowest first.
number
Filter: maximum USD price. Example: 100 to find assets under $100.
number
Filter: minimum USD price. Example: 0.01 to exclude very cheap assets.
string
Alternative to ‘convert’: CoinMarketCap ID of quote currency (e.g., ‘2781’ for USD, ‘1’ for BTC)
number
Filter: maximum market cap in USD. Example: 10000000 for small caps under $10M.
number
Filter: minimum market cap in USD. Example: 1000000000 for $1B+ market cap.
number
Filter: maximum 24h trading volume in USD.
number
Filter: minimum 24h trading volume in USD. Example: 1000000 for $1M+ daily volume.
string ("all" | "coins" | "tokens")
Filter by asset type. ‘coins’ = native coins like BTC/ETH, ‘tokens’ = tokens on other platforms, ‘all’ = both. Default: all
number
Filter: maximum circulating supply (number of coins/tokens).
number
Filter: minimum circulating supply (number of coins/tokens).
number
Filter: maximum 24h price change percentage. Example: 50 to exclude extreme gainers.
number
Filter: minimum 24h price change percentage. Example: -10 to exclude assets down more than 10%.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINMARKETCAP_CRYPTOCURRENCY_MAPRetrieve a paginated cryptocurrency mapping with IDs, symbols, and names for reference. Results are under data; by default the request selects active listings and returns up to 100 entries per page.

Input Parameters

string
Comma-separated CoinMarketCap IDs to filter, e.g., ‘1,1027’. Note: This parameter may require a paid API plan.
string
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.
string
Comma-separated URL slugs to filter, e.g., ‘bitcoin,ethereum’.
string ("id" | "cmc_rank")
Field to sort by: ‘id’ or ‘cmc_rank’.
integer
Number of results to return, between 1 and 5000.
integer
1-based index of the first item to return.
string
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.
string
Comma-separated list of statuses to include: active, inactive, untracked. Defaults to ‘active’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINMARKETCAP_CRYPTOCURRENCY_QUOTES_LATESTTool 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

string
Comma-separated CoinMarketCap cryptocurrency IDs. Provide this or symbol or slug. Limit batches to ~100 IDs per call.
string
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.
string
Comma-separated cryptocurrency slugs. Provide this or id or symbol.
string
Comma-separated cryptocurrency symbols. Provide this or id or slug.
string
Fiat or cryptocurrency symbol to convert values into. Cannot be used with convert_id.
string
Comma-separated CoinMarketCap IDs for conversion currencies. Cannot be used with convert.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINMARKETCAP_GET_CRYPTOCURRENCY_INFOTool 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

array
List of CoinMarketCap cryptocurrency IDs. Required if slug and symbol are not provided.
array
List of cryptocurrency slugs (e.g., [‘bitcoin’, ‘ethereum’]). Required if id and symbol are not provided.
array
List of cryptocurrency symbols (e.g., [‘BTC’, ‘ETH’]). Required if id and slug are not provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINMARKETCAP_GET_EXCHANGE_INFOTool to get detailed metadata for one or more exchanges. Use when you need exchange logos, supported fiats, launch dates, and official links.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINMARKETCAP_GET_KEY_INFOTool to retrieve your CoinMarketCap API key details, rate limits, and usage statistics. Use after setting your API key to inspect limits and usage.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINMARKETCAP_GLOBAL_METRICS_QUOTES_LATESTTool to obtain the latest global cryptocurrency market metrics (market cap, volume, dominance). Use when you need aggregated market-level data for analysis.

Input Parameters

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINMARKETCAP_PARTNER_MAPRetrieve CoinMarketCap partner information as ID, name, and slug mappings for identifying records by name or slug. Results may also represent exchanges. Supports listing-status and slug filters and pagination, with a limit of 1 to 5,000 results per request.

Input Parameters

string
Comma-separated slugs to filter. Example: ‘binance,gdax’
integer
Number of results to return (1-5000).
integer
1-based index of the first item to return for pagination.
string
Filter by listing status. Example: ‘active’, ‘inactive’, ‘untracked’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINMARKETCAP_TOOLS_PRICE_CONVERSIONTool 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not