CoinMarketCal

CoinMarketCal API

CoinMarketCal API と MCP サーバーの公式サンプルです。

CoinMarketCal は、暗号資産のイベントカレンダーです。各イベントには、日付、対象となるコイン、編集カテゴリ、影響度スコア、情報源が含まれています。同じデータを REST API と、AI エージェント向けの MCP サーバーから利用できます。

• 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 エージェントから利用する（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）

データとライセンス

このリポジトリのコードは、MIT license に基づいて公開されています。このコードを使ってアクセスする CoinMarketCal のデータには、API Terms of Service が適用されます。

サポート

API に関するお問い合わせ：[email protected]。