cmc-api-crypto

CoinMarketCap 暗号資産 API

このスキルでは、価格データ、マーケット一覧、過去の価格情報、トレンドのコイン、トークンのメタデータを取得するための CoinMarketCap Cryptocurrency API エンドポイントを扱います。

認証

すべてのリクエストで、ヘッダーに API キーが必要です。

curl -X GET "https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/latest" \
  -H "X-CMC_PRO_API_KEY: your-api-key"

API キーはこちらから取得できます：https://pro.coinmarketcap.com/login

ベース URL

https://pro-api.coinmarketcap.com

よくあるユースケース

使用するエンドポイントについて目的別のガイダンスを確認するには、use-cases.md をご覧ください。

1. トークンの現在価格を取得する
2. シンボルまたは名前からトークンの CMC ID を調べる
3. コントラクトアドレスからトークンを取得する
4. 時価総額上位 100 コインを取得する
5. 指定した価格帯のコインを探す
6. 特定の日付の過去価格を取得する
7. 価格チャートを作成する（OHLCV データ）
8. コインが取引されている場所を調べる
9. 史上最高値と ATH からの差を取得する
10. 今日の値上がり率上位のコインを調べる
11. 新たに上場したコインを見つける
12. カテゴリー内のすべてのトークンを取得する（例：DeFi）

API の概要

エンドポイント	説明	リファレンス
GET /v1/cryptocurrency/categories	市場指標とともにすべてのカテゴリーを一覧表示	categories.md
GET /v1/cryptocurrency/category	単一カテゴリーの詳細	categories.md
GET /v1/cryptocurrency/listings/historical	過去の一覧スナップショット	listings.md
GET /v1/cryptocurrency/listings/latest	市場データ付きの現在の一覧	listings.md
GET /v1/cryptocurrency/listings/new	新たに追加された暗号資産	listings.md
GET /v1/cryptocurrency/map	名前／シンボルを CMC ID に対応付け	map.md
GET /v1/cryptocurrency/trending/gainers-losers	値上がり率上位と値下がり率上位のコイン	trending.md
GET /v1/cryptocurrency/trending/latest	現在トレンドのコイン	trending.md
GET /v1/cryptocurrency/trending/most-visited	CMC で最も閲覧されているコイン	trending.md
GET /v2/cryptocurrency/info	静的メタデータ（ロゴ、説明、URL）	info.md
GET /v2/cryptocurrency/market-pairs/latest	コインの取引ペア	market-pairs.md
GET /v2/cryptocurrency/ohlcv/historical	過去の OHLCV ローソク足データ	ohlcv.md
GET /v2/cryptocurrency/ohlcv/latest	最新の OHLCV データ	ohlcv.md
GET /v2/cryptocurrency/price-performance-stats/latest	価格パフォーマンスの統計	price-performance.md
GET /v2/cryptocurrency/quotes/latest	最新の価格情報	quotes.md
GET /v3/cryptocurrency/quotes/historical	過去の価格情報	quotes.md

よくあるワークフロー

シンボルからトークン価格を取得する

1. まず、/v1/cryptocurrency/map を使ってシンボルを CMC ID に対応付けます
2. 次に、/v2/cryptocurrency/quotes/latest を使って価格を取得します

# Step 1: Get CMC ID for ETH
curl -X GET "https://pro-api.coinmarketcap.com/v1/cryptocurrency/map?symbol=ETH" \
  -H "X-CMC_PRO_API_KEY: your-api-key"

# Step 2: Get price quote (using id=1027 for ETH)
curl -X GET "https://pro-api.coinmarketcap.com/v2/cryptocurrency/quotes/latest?id=1027" \
  -H "X-CMC_PRO_API_KEY: your-api-key"

時価総額上位 100 コインを取得する

curl -X GET "https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/latest?limit=100&sort=market_cap" \
  -H "X-CMC_PRO_API_KEY: your-api-key"

過去の価格データを取得する

curl -X GET "https://pro-api.coinmarketcap.com/v3/cryptocurrency/quotes/historical?id=1&time_start=2024-01-01&time_end=2024-01-31&interval=daily" \
  -H "X-CMC_PRO_API_KEY: your-api-key"

トークンのメタデータを取得する

curl -X GET "https://pro-api.coinmarketcap.com/v2/cryptocurrency/info?id=1,1027" \
  -H "X-CMC_PRO_API_KEY: your-api-key"

エラー処理

HTTP ステータスコード

コード	意味
200	成功
400	不正なリクエスト（パラメーターが無効）
401	認証されていない（API キーが無効）
403	アクセス禁止（ご利用のプランではエンドポイントを利用できません）
429	レート制限を超過
500	サーバーエラー

レート制限

レート制限はサブスクリプションプランによって異なります。レスポンスヘッダーには次の情報が含まれます。

1. X-CMC_PRO_API_KEY_CREDITS_USED - 今回の呼び出しで使用したクレジット数
2. X-CMC_PRO_API_KEY_CREDITS_LEFT - 残りのクレジット数

よくあるエラー

無効な ID：/map エンドポイントから取得した有効な CMC ID を使用してください。シンボル検索では複数の一致が返されることがあります。

必須パラメーターの不足：エンドポイントによっては、少なくとも 1 つの識別子（id、slug、または symbol）が必要です。

プランの制限：過去データのエンドポイントや一部の機能には有料プランが必要です。プランの利用上限をご確認ください。

エラーレスポンス形式

{
  "status": {
    "timestamp": "2024-01-15T12:00:00.000Z",
    "error_code": 400,
    "error_message": "Invalid value for 'id'",
    "credit_count": 0
  }
}

レスポンス形式

すべてのレスポンスは、次の構造に従います。

{
  "status": {
    "timestamp": "2024-01-15T12:00:00.000Z",
    "error_code": 0,
    "error_message": null,
    "credit_count": 1
  },
  "data": { ... }
}

リファレンスファイル

各エンドポイントのパラメーターとレスポンスに関する詳細なドキュメントは、references/ ディレクトリを参照してください。