NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
CoinMarketCap connects to a Nagent workspace with an API key. Once it is connected, agents can call 9 CoinMarketCap actions, such as "Get Latest Cryptocurrency Quotes", "Get cryptocurrency info" and "Get exchange info". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against CoinMarketCap, with input parameters and output schema.
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
Agents can call 9 CoinMarketCap actions on Nagent, including "Get Latest Cryptocurrency Quotes", "Get cryptocurrency info" and "Get exchange info". Get Latest Cryptocurrency Quotes: Get the latest aggregated global market quotes for one or more cryptocurrencies. Each action is listed on this page with its input parameters and its output.
CoinMarketCap connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It also takes 7 optional inputs: id, aux, slug, symbol, convert, convert_id and skip_invalid. It returns data, error and successful.