mcpField
C
cmc-api-exchange

cmc-api-exchange

github.com/opencmcデータ・データベース75105 回インストール5 日前に更新
リポジトリ

cmc-api-exchange について

cmc-api-exchangeは、CoinMarketCapの中央集権型暗号資産取引所APIを扱うスキルです。APIキーを使い、取引所情報、取引量、取引ペア、保有資産を取得する方法を案内します。

主な機能

  1. 01取引所名からCMC IDを特定
  2. 02取引所メタデータの取得
  3. 03現在と過去の取引量を比較
  4. 04取引所の取引ペア一覧を取得
  5. 05取引所保有資産の確認

活用シーン

  1. 01取引所のCMC IDを調べる
  2. 02取引所間の取引量を比較
  3. 03BTCや先物のペアを探す
  4. 04取引所の準備金を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/opencmc/skills-for-ai-agents-by-coinmarketcap --skill cmc-api-exchange

インストール後、Claude Code で/cmc-api-exchangeを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
assets.md
info.md
listings.md
market-pairs.md
quotes.md
use-cases.md

詳細

CoinMarketCap Exchange API スキル

このスキルでは、中央集権型暗号資産取引所（Binance、Coinbase、Kraken など）向けの CoinMarketCap API を扱います。これらのエンドポイントを使用して、取引所のメタデータ、取引高、取引ペア、保有資産を取得できます。

認証

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

  1. https://pro.coinmarketcap.com/login で API キーを取得します
  2. すべてのリクエストに X-CMC_PRO_API_KEY: your-api-key ヘッダーを含めます
curl -X GET "https://pro-api.coinmarketcap.com/v1/exchange/map" \
  -H "X-CMC_PRO_API_KEY: your-api-key"

ベース URL

https://pro-api.coinmarketcap.com

よくある使用例

どのエンドポイントを使用するかについては、目的別のガイダンスが記載された use-cases.md を参照してください。

  1. 名前で取引所の情報を取得する
  2. 取引所の CMC ID を調べる
  3. 取引高上位の取引所を取得する
  4. 現物取引所のみ（またはデリバティブのみ）を取得する
  5. 特定の取引所の現在の取引高を取得する
  6. 複数の取引所の取引高を比較する
  7. 取引所の過去の取引高を取得する
  8. 取引所のすべての取引ペアを取得する
  9. 取引所の BTC ペアを調べる
  10. 取引所の無期限／先物ペアを取得する
  11. 取引所の準備金（プルーフ・オブ・リザーブ）を確認する
  12. 特定のコインを取り扱っている取引所を調べる

API の概要

エンドポイント説明リファレンス
GET /v1/exchange/map取引所名を CMC ID に対応付けるreferences/info.md
GET /v1/exchange/info取引所のメタデータ（ロゴ、URL、説明）references/info.md
GET /v1/exchange/listings/latest市場データ付きですべての取引所を一覧表示するreferences/listings.md
GET /v1/exchange/quotes/latest最新の取引所取引高と指標references/quotes.md
GET /v1/exchange/quotes/historical取引所の過去の取引高データreferences/quotes.md
GET /v1/exchange/market-pairs/latest取引所の取引ペアreferences/market-pairs.md
GET /v1/exchange/assets取引所が保有する資産references/assets.md

よくあるワークフロー

取引所の情報を取得する

理由： ほとんどのエンドポイントでは名前ではなく、CMC 取引所 ID が必要です。マップエンドポイントを使うと、人が読めるスラッグを ID に変換できます。

  1. /v1/exchange/map に slug=binance を指定して呼び出し、取引所 ID を取得します
  2. ID を指定して /v1/exchange/info を呼び出し、完全なメタデータを取得します
取引所の取引高を比較する

理由： 取引高は流動性と信頼性を示します。取引高が多いほど、価格執行が良くなり、スリッページが小さくなります。

  1. /v1/exchange/listings/latest を呼び出し、取引高順にランク付けされたすべての取引所を取得します
  2. 降順に並べるには、sort=volume_24h と sort_dir=desc を使用します
取引ペアを分析する

理由： 利用できるペアを把握すると、ユーザーが特定の資産を取引する場所を見つけたり、取引所間の流動性を比較したりするのに役立ちます。

  1. /v1/exchange/map から取引所 ID を取得します
  2. その ID を指定して /v1/exchange/market-pairs/latest を呼び出します
  3. 必要に応じて category=spot または category=derivatives で絞り込みます
取引高の履歴を追跡する

理由： 過去の取引高から傾向がわかります。取引高の減少はユーザー離れを示唆する場合があります。急増はウォッシュトレードやニュースによる可能性があります。

  1. /v1/exchange/map から取引所 ID を取得します
  2. 日付範囲のパラメーターを指定して /v1/exchange/quotes/historical を呼び出します

クエリパラメーター

ほとんどのエンドポイントでは、次の共通パラメーターを使用できます。

パラメーター型説明
idstringCMC 取引所 ID（複数の場合はカンマ区切り）
slugstring取引所のスラッグ（例："binance"）
convertstring価格換算に使用する通貨（デフォルト：USD）
auxstringレスポンスに含める追加フィールド

エラー処理

すべてのレスポンスに status オブジェクトが含まれます。

{
  "status": {
    "timestamp": "2024-01-15T12:00:00.000Z",
    "error_code": 0,
    "error_message": null,
    "credit_count": 1
  },
  "data": { }
}
よくあるエラーコード
コード意味
0成功
400不正なリクエスト（無効なパラメーター）
401認証されていない（API キーが無効）
403アクセス禁止（プランの上限超過）
429レート制限超過
500内部サーバーエラー
レート制限

レート制限は、契約プランによって異なります。レスポンス内の credit_count を確認して、API クレジットの使用状況を把握してください。すべてのリクエストに X-CMC-PRO-API-KEY ヘッダーを含める必要があります。

レスポンス形式

すべてのレスポンスは、次の構造の JSON を返します。

{
  "status": { },
  "data": { }
}

data フィールドには、エンドポイントに応じてオブジェクト（単一の項目）または配列（複数の項目）が含まれます。

コメント

Markdown 対応