> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CoinMarketCal

> CoinMarketCal is a community-driven crypto calendar, highlighting upcoming events, announcements, and releases, helping traders and enthusiasts track market-impacting developments in the cryptocurrency space

![CoinMarketCal logo](https://mintcdn.com/composio-preview/NPf8agM6UrvZD-Iu/images/toolkits/coinmarketcal.svg?fit=max\&auto=format\&n=NPf8agM6UrvZD-Iu\&q=85\&s=67bd0d0c5c7ab52819286755754307e9)

* **Category:** analytics
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 3
* **Triggers:** 0
* **Slug:** `COINMARKETCAL`
* **Version:** 20261014\_00

## Tools

> [accordion] List Coins
>
> **Slug:** `COINMARKETCAL_LIST_COINS`
>
> Tool to retrieve list of all available coins/cryptocurrencies in CoinMarketCal database. Use when you need to fetch coin information including IDs, names, symbols, and event counts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Event Categories
>
> **Slug:** `COINMARKETCAL_LIST_EVENT_CATEGORIES`
>
> Tool to list all event categories. Use when you need to fetch available event categories.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Cryptocurrency Events
>
> **Slug:** `COINMARKETCAL_LIST_EVENTS`
>
> Tool to retrieve list of cryptocurrency events. Use when you need to fetch upcoming or past crypto events filtered by date range, coins, categories, or other criteria. Note: Cannot retrieve events before 25/11/2017. The can\_occur\_before field is important as some events may happen before their stated date.
>
> #### Input Parameters
>
> **max** `integer`
>
> Maximum amount of events to display per page (default: 16, max: 300)
>
> **page** `integer`
>
> Page number for pagination (default: 1)
>
> **coins** `string`
>
> Comma-separated list of coin IDs to filter events by specific cryptocurrencies
>
> **sortBy** `string ("created_desc" | "hot_events" | "trending_events" | "significant_events")`
>
> The order in which the results will be listed
>
> **showOnly** `string ("hot_events" | "trending_events" | "significant_events")`
>
> Filter to show only specific types of events
>
> **showViews** `boolean`
>
> Include the number of views for each event in the response
>
> **showVotes** `boolean`
>
> Include vote information for each event in the response
>
> **categories** `string`
>
> Comma-separated list of category IDs to filter events by type
>
> **dateRangeEnd** `string`
>
> End date for filtering events (format: YYYY-MM-DD). Default is the date of the furthest event.
>
> **translations** `string ("en" | "ko" | "ru" | "tr" | "ja" | "es" | "pl" | "pt" | "id")`
>
> Language code for translations. Supported: en, ko, ru, tr, ja, es, pl, pt, id
>
> **dateRangeStart** `string`
>
> Start date for filtering events (format: YYYY-MM-DD). Default is today. Cannot be before 2017-11-25.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
