CoinMarketCap provides a comprehensive cryptocurrency market data API, offering real-time and historical data on cryptocurrencies and exchanges.
CoinMarketCap provides a comprehensive cryptocurrency market data API, offering real-time and historical data on cryptocurrencies and exchanges. On Nagent, CoinMarketCap is exposed as a fully-configurable analytics integration that any agent can call — 9 actions, and API key authentication. No code is required to wire CoinMarketCap into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use CoinMarketCap to automate the kinds of tasks analytics teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire CoinMarketCap into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against CoinMarketCap, with input parameters and output schema. Drop these into any step of an agent built in Helix.
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
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
Filter by tag (e.g., 'defi', 'stablecoin', 'layer-1', 'memes'). Use comma for multiple.
Sort field. Default: market_cap. Options: market_cap, price, volume_24h, percent_change_24h, name
Number of results to return (1-5000). Default: 100. Use with 'start' for pagination.
1-based pagination offset (e.g., start=101 to skip first 100 results). Default: 1
Quote currency symbol (e.g., 'USD', 'EUR', 'BTC'). Default: USD. Note: API plan may limit to 1 convert option.
Sort direction. Default: desc (highest first). Use 'asc' for lowest first.
Filter: maximum USD price. Example: 100 to find assets under $100.
Filter: minimum USD price. Example: 0.01 to exclude very cheap assets.
Alternative to 'convert': CoinMarketCap ID of quote currency (e.g., '2781' for USD, '1' for BTC)
Filter: maximum market cap in USD. Example: 10000000 for small caps under $10M.
Filter: minimum market cap in USD. Example: 1000000000 for $1B+ market cap.
Filter: maximum 24h trading volume in USD.
Filter: minimum 24h trading volume in USD. Example: 1000000 for $1M+ daily volume.
Filter by asset type. 'coins' = native coins like BTC/ETH, 'tokens' = tokens on other platforms, 'all' = both. Default: all
Filter: maximum circulating supply (number of coins/tokens).
Filter: minimum circulating supply (number of coins/tokens).
Filter: maximum 24h price change percentage. Example: 50 to exclude extreme gainers.
Filter: minimum 24h price change percentage. Example: -10 to exclude assets down more than 10%.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COINMARKETCAP_CRYPTOCURRENCY_MAPTool 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
Comma-separated CoinMarketCap IDs to filter, e.g., '1,1027'. Note: This parameter may require a paid API plan.
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.
Comma-separated URL slugs to filter, e.g., 'bitcoin,ethereum'.
Field to sort by: 'id' or 'cmc_rank'.
Number of results to return, between 1 and 5000.
1-based index of the first item to return.
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.
Comma-separated list of statuses to include: active, inactive, untracked. Defaults to 'active'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Comma-separated CoinMarketCap cryptocurrency IDs. Provide this or symbol or slug. Limit batches to ~100 IDs per call.
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.
Comma-separated cryptocurrency slugs. Provide this or id or symbol.
Comma-separated cryptocurrency symbols. Provide this or id or slug.
Fiat or cryptocurrency symbol to convert values into. Cannot be used with convert_id.
Comma-separated CoinMarketCap IDs for conversion currencies. Cannot be used with convert.
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
List of CoinMarketCap cryptocurrency IDs. Required if `slug` and `symbol` are not provided.
List of cryptocurrency slugs (e.g., \['bitcoin', 'ethereum'\]). Required if `id` and `symbol` are not provided.
List of cryptocurrency symbols (e.g., \['BTC', 'ETH'\]). Required if `id` and `slug` are not provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
List of CoinMarketCap exchange IDs. Required if `slug` is not provided.
Comma-separated list of additional metadata fields to include: logo, description, date_launched, notice, countries, fiats, urls.
List of exchange slugs (e.g., \['binance', 'kraken'\]). Required if `id` is not provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
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.
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COINMARKETCAP_PARTNER_MAPTool 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
Comma-separated slugs to filter. Example: 'binance,gdax'
Number of results to return (1-5000).
1-based index of the first item to return for pagination.
Filter by listing status. Example: 'active', 'inactive', 'untracked'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
CoinMarketCap ID of the source currency. Use this or 'symbol'. Example: 1 for Bitcoin, 1027 for Ethereum, 2781 for USD.
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 of the cryptocurrency or fiat currency to convert. Must be >= 1e-8.
Ticker symbol of the source currency (e.g., 'BTC', 'ETH', 'USD'). Use this or 'id'. Case-insensitive.
Target currency symbol to convert to (e.g., 'USD', 'EUR', 'BTC'). Defaults to USD if omitted. Use 'convert' or 'convert_id', not both.
CoinMarketCap ID of the target currency (e.g., '2781' for USD). Use 'convert' or 'convert_id', not both.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 65 agents privately built on Nagent that already use CoinMarketCap.
Build on Nagent
Connect CoinMarketCap to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find CoinMarketCap, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, CoinMarketCap is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once CoinMarketCap is connected, you configure its 9 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop CoinMarketCap steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a CoinMarketCap event fires, the agent kicks off automatically.
Every CoinMarketCap action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While CoinMarketCap ships with 9 pre-built analytics actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching CoinMarketCap together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build CoinMarketCap-based workflows tailored to your business.