cmc-api-market

CoinMarketCap Market API スキル

このスキルでは、グローバル指標、センチメント指標、市場インデックス、コミュニティのアクティビティ、ニュースコンテンツ、チャートデータ、ユーティリティエンドポイントなど、市場全体の暗号資産データを扱います。

認証

すべてのリクエストで X-CMC_PRO_API_KEY ヘッダーが必要です。

curl -X GET "https://pro-api.coinmarketcap.com/v1/global-metrics/quotes/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. 現在の市場センチメント（Fear & Greed）を取得する
2. 暗号資産市場全体の時価総額を取得する
3. BTC ドミナンスを取得する
4. 時価総額の推移を追跡する
5. Fear & Greed の推移を追跡する
6. CMC100 インデックスのパフォーマンスを取得する
7. CMC100 と CMC20 を比較する
8. チャート用の OHLCV ローソク足データを取得する
9. シンプルな価格時系列データを取得する
10. コミュニティでトレンドになっているトークンを取得する
11. トレンドになっているディスカッショントピックを取得する
12. 最新の暗号資産ニュースを取得する
13. 通貨の金額を換算する
14. API の使用状況と制限を確認する
15. 法定通貨 ID を取得する

API の概要

グローバル指標

エンドポイント	説明	リファレンス
GET /v1/global-metrics/quotes/historical	過去のグローバル市場指標	global-metrics.md
GET /v1/global-metrics/quotes/latest	最新の市場全体の時価総額、BTC ドミナンス	global-metrics.md

Fear and Greed Index

エンドポイント	説明	リファレンス
GET /v3/fear-and-greed/historical	過去の Fear/Greed 値	fear-greed.md
GET /v3/fear-and-greed/latest	現在の市場センチメントスコア	fear-greed.md

市場インデックス

エンドポイント	説明	リファレンス
GET /v3/index/cmc100-historical	CMC100 インデックスの履歴	indices.md
GET /v3/index/cmc100-latest	CMC100 の現在値	indices.md
GET /v3/index/cmc20-historical	CMC20 インデックスの履歴	indices.md
GET /v3/index/cmc20-latest	CMC20 の現在値	indices.md

コミュニティ

エンドポイント	説明	リファレンス
GET /v1/community/trending/token	コミュニティのアクティビティを基準にしたトレンドトークン	community.md
GET /v1/community/trending/topic	トレンドになっているディスカッショントピック	community.md

コンテンツ

エンドポイント	説明	リファレンス
GET /v1/content/latest	最新ニュースと Alexandria の記事	content.md
GET /v1/content/posts/comments	特定の投稿へのコメント	content.md
GET /v1/content/posts/latest	最新のコミュニティ投稿	content.md
GET /v1/content/posts/top	評価の高いコミュニティ投稿	content.md

K ラインチャート

エンドポイント	説明	リファレンス
GET /v1/k-line/candles	OHLCV ローソク足データ	kline.md
GET /v1/k-line/points	価格／時価総額の時系列データポイント	kline.md

ツール

エンドポイント	説明	リファレンス
GET /v1/fiat/map	法定通貨を CMC ID に対応付ける	tools.md
GET /v1/key/info	API キーの使用状況とプランの詳細	tools.md
GET /v2/tools/price-conversion	通貨間で換算する	tools.md

一般的なワークフロー

市場センチメントの概要を取得する

1. Fear/Greed インデックスを取得します：/v3/fear-and-greed/latest
2. グローバル指標を取得します：/v1/global-metrics/quotes/latest
3. 時価総額の状況と組み合わせてセンチメントを分析します

市場インデックスのパフォーマンスを追跡する

1. 現在のCMC100値を取得します：/v3/index/cmc100-latest
2. 履歴データを取得します：/v3/index/cmc100-historical
3. 時間の経過に伴うパフォーマンスを比較します

コミュニティのアクティビティを監視する

1. トレンドのトークンを確認します：/v1/community/trending/token
2. トレンドのトピックを確認します：/v1/community/trending/topic
3. 最新の投稿を読みます：/v1/content/posts/top

価格チャートを作成する

1. OHLCV のローソク足データを取得します：/v1/k-line/candles
2. 時間枠には interval パラメーター（1h、4h、1d）を使用します
3. 返されたデータでローソク足チャートを描画します

通貨換算

1. 法定通貨の ID を取得します：/v1/fiat/map
2. 金額を換算します：/v2/tools/price-conversion

エラー処理

ステータスコード	意味	対応
400	不正なリクエスト	パラメーターの値と形式を確認してください
401	認証されていません	API キーが有効か確認してください
403	アクセスが禁止されています	エンドポイントはご利用のプランでは使用できません
429	レート制限に達しました	待機してから、バックオフを適用して再試行してください
500	サーバーエラー	少し待ってから再試行してください

エラーレスポンスの形式

{
  "status": {
    "error_code": 400,
    "error_message": "Invalid value for 'id'"
  }
}

レート制限ヘッダー

使用状況を監視するには、次のレスポンスヘッダーを確認してください：

1. X-CMC_PRO_API_KEY_CREDITS_USED - 消費したクレジット数
2. X-CMC_PRO_API_KEY_CREDITS_REMAINING - 残りのクレジット数
3. X-CMC_PRO_API_KEY_RATE_LIMIT - 1 分あたりのリクエスト上限

レスポンス形式

すべてのエンドポイントは、次の構造の JSON を返します：

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

ヒント

1. 大量に利用する前に /v1/key/info エンドポイントを使って、プランの上限を確認してください
2. グローバル指標データは数分ごとに更新されるため、キャッシュしてください
3. 恐怖・強欲指数は毎日更新されるため、頻繁にポーリングする必要はありません
4. K 線データは、さまざまなチャートの時間枠に対応する複数の間隔をサポートしています
5. コミュニティのトレンドデータは、1 日を通して定期的に更新されます