CoinMarketCal

Name: CoinMarketCal
Author: coinmarketcal.com

远程服务

coinmarketcal.com金融数据02 周前更新

代码仓库访问官网

关于 CoinMarketCal

CoinMarketCal 是面向开发者和 AI Agent 的加密货币事件日历，提供带日期、来源和影响评分的事件数据。数据可通过 REST API 和 MCP 服务获取。

主要功能

01浏览加密货币事件
02事件日期与估算日期标记
03受影响的币种和编辑分类
04影响评分与来源链接
05读取事件详情和币种列表

适用场景

01查找某个币种的后续事件
02查看事件详情及其来源
03在 AI Agent 中使用事件数据
04分页获取事件列表

MCP 相关

MCP 服务将 API 的只读端点作为工具提供，包括事件列表、事件详情和币种列表。它与 REST API 共用 API 密钥和配额。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://coinmarketcal.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http com-coinmarketcal-events https://coinmarketcal.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"com-coinmarketcal-events":{"type":"http","url":"https://coinmarketcal.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"com-coinmarketcal-events":{"type":"http","url":"https://coinmarketcal.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"com-coinmarketcal-events":{"type":"http","url":"https://coinmarketcal.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"com-coinmarketcal-events":{"serverUrl":"https://coinmarketcal.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址

Streamable HTTPhttps://coinmarketcal.com/mcp需要授权

工具

参数	类型	必填	说明
to	string	否	`date` 的包含式上限。默认值 = 今天 + 套餐等级对应的未来日期范围（例如，Free 为 7 天，Standard 为 90 天，Pro+ 为全部）。
from	string	否	`date` 的包含式下限。默认值 = 今天。Free 和 Standard 会将过去的值限制为今天；Pro 会限制为前 30 天；Elite 和 Enterprise 可查询自 2017 年以来的完整公开目录历史记录。
coins	string	否	以逗号分隔的币种 slug（例如 `bitcoin,ethereum`）。也接受 ticker，但强烈不建议使用；不同币种可能使用相同代码（例如，`UNI` 会匹配多个不同项目）。使用 `GET /v2/coins` 查询标准 slug。
limit	integer	否	页面大小（1–100）。
cursor	string	否	上一条响应的 `meta.cursor` 中返回的不透明分页游标。
sortBy	enum	否	排序方式。默认值为 `date_asc`（最早的在前）。仅 Elite+ 可使用 `impact_desc`；较低等级会收到 403。date_asc \| date_desc \| created_desc \| created_desc_and_updated_desc \| impact_desc
keyword	string	否	在活动标题和描述中进行自由文本搜索。不区分大小写的子字符串匹配。
impactMin	number	否	精确影响分数的下限（0.0–10.0）。仅 Elite+ 可用；较低等级会收到 403。
categories	string	否	以逗号分隔的类别 ID。不区分大小写。仅 Standard+ 可用；Free 请求使用此筛选条件时会返回 403。使用 `GET /v2/categories` 查询标准 ID 列表。

详细介绍

CoinMarketCal API

CoinMarketCal API 和 MCP 服务的官方示例。

CoinMarketCal 是一个加密货币事件日历。每个事件都包含日期、受影响的币种、编辑分类、影响评分和来源。相同的数据可通过 REST API 和 MCP 服务供 AI Agent 使用。

获取 API 密钥： coinmarketcal.com/developer（提供免费套餐）
文档： coinmarketcal.com/developer/docs
OpenAPI 规范： openapi.json
MCP 服务： https://coinmarketcal.com/mcp（设置指南，MCP Registry：com.coinmarketcal/events）

快速开始

每个请求都要在 x-api-key 标头中发送你的密钥。

curl -s "https://api.coinmarketcal.com/v2/events?coins=ethereum&limit=5" \
  -H "x-api-key: $COINMARKETCAL_API_KEY"

每个事件的格式如下（字段取决于你的套餐）：

{
  "id": "48291",
  "slug": "ethereum-pectra-upgrade",
  "title": "Ethereum Pectra Upgrade",
  "date": "2026-05-06T12:00:00Z",
  "dateType": "date",
  "isEstimated": false,
  "displayedDate": "06 May 2026",
  "categories": ["Release"],
  "coins": [{ "slug": "ethereum", "symbol": "eth", "name": "Ethereum" }],
  "impact": 8.5
}

当 isEstimated 为 true 时，date 表示截止日期或时间范围的结束日期，而非确切日期。请向用户显示 displayedDate（例如 Q2 2026 或 By 30 May 2026）。

在 AI Agent 中使用（MCP）

MCP 服务将 API 的读取端点作为工具公开（list_events、get_event、list_coins，等等）。事件结果包含 coinmarketcal.com 上事件页面的 url。它与 REST API 使用相同的密钥和配额。

客户端	配置
Claude Code	`mcp/claude-code.sh`
Cursor、VS Code 和使用 `mcpServers` 的客户端	`mcp/mcp.json`
Codex CLI	`mcp/codex.toml`
Claude Desktop 和不支持远程 HTTP 的客户端	`mcp/mcp-remote.json`

将 YOUR_API_KEY 替换为你的密钥。

示例

示例	功能
`examples/curl.sh`	列出即将发生的事件、读取单个事件、查询币种
`examples/python/upcoming_events.py`	分页获取某个币种的所有即将发生的事件
`examples/javascript/upcoming-events.mjs`	使用 Node.js 18+（`fetch`）实现相同功能
`examples/webhooks/`	验证 Webhook 投递的 `CMC-Signature` 标头（Node.js、Python、PHP）