# 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

- **Category:** analytics
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 3
- **Triggers:** 0
- **Slug:** `COINMARKETCAL`
- **Version:** 20260223_00

## Tools

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Event Categories

**Slug:** `COINMARKETCAL_LIST_EVENT_CATEGORIES`

Tool to list all event categories. Use when you need to fetch available event categories.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `max` | integer | No | Maximum amount of events to display per page (default: 16, max: 300) |
| `page` | integer | No | Page number for pagination (default: 1) |
| `coins` | string | No | Comma-separated list of coin IDs to filter events by specific cryptocurrencies |
| `sortBy` | string ("created_desc" | "hot_events" | "trending_events" | "significant_events") | No | The order in which the results will be listed |
| `showOnly` | string ("hot_events" | "trending_events" | "significant_events") | No | Filter to show only specific types of events |
| `showViews` | boolean | No | Include the number of views for each event in the response |
| `showVotes` | boolean | No | Include vote information for each event in the response |
| `categories` | string | No | Comma-separated list of category IDs to filter events by type |
| `dateRangeEnd` | string | No | 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") | No | Language code for translations. Supported: en, ko, ru, tr, ja, es, pl, pt, id |
| `dateRangeStart` | string | No | Start date for filtering events (format: YYYY-MM-DD). Default is today. Cannot be before 2017-11-25. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |