CoinMarketCap Trending Coins Tool

CMC Trending Coins Tool (cmc_trending_coins_tool)

Fetches a list of the top active cryptocurrencies ranked by market capitalization from the CoinMarketCap (CMC) Pro API, providing key market data for each.

Input: Accepts an optional limit for the number of coins to retrieve.

class CMCTrendingCoinsInput(BaseModel):
    limit: int = 20 # Number of coins (default 20, max 100)

---

Key Functionality:

• Retrieves a list of top cryptocurrencies (e.g., Bitcoin, Ethereum) sorted by market cap from the pro-api.coinmarketcap.com.

• For each coin, it provides its CMC rank, name, symbol, current price in USD, market capitalization, and 24-hour price change percentage.

• The number of results can be specified using limit, up to a maximum of 100.

---

Sample Usage Queries (How an AI might use it):

• "What are the top 10 cryptocurrencies by market cap from CoinMarketCap?"

• "Show me the leading 25 coins according to CMC."

• "Get CoinMarketCap's list of top cryptocurrencies."

• "List the top coins with a limit of 50 from CMC."

• "Which coins are currently at the top of CoinMarketCap rankings?"

• "Fetch the top 100 crypto listings from CMC."

• "Can you show me CoinMarketCap's main cryptocurrency list?"

• "What are the leading cryptocurrencies today via CMC?"

---

class CMCTrendingCoinsTool(BaseTool):
    name: ClassVar[str] = "cmc_trending_coins_tool"
    description: ClassVar[str] = "Get a list of all active cryptocurrencies with latest market data from CoinMarketCap."
    args_schema: ClassVar[Type[BaseModel]] = CMCTrendingCoinsInput

---

Important:

• This tool operates asynchronously (_arun) only.

• Requires a valid CoinMarketCap Pro API Key (CONFIG.CMC_API_KEY) to be configured in the backend.

• The limit parameter defaults to 20 and is capped at a maximum of 100 coins.