cmc-api-dex

CoinMarketCap DEX API

このスキルでは、オンチェーンのトークンデータを取得する CoinMarketCap の DEX（分散型取引所）API を扱います。CEX エンドポイントとは異なり、これらの API は Uniswap、PancakeSwap、Raydium などのブロックチェーン上の DEX から直接データを取得します。

認証

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

curl -X GET "https://pro-api.coinmarketcap.com/v1/dex/platform/list" \
  -H "X-CMC_PRO_API_KEY: your-api-key"

API キーは https://pro.coinmarketcap.com/login で取得してください。

ベース URL

https://pro-api.coinmarketcap.com

POST エンドポイントと GET エンドポイント

多くの DEX エンドポイントでは、リクエスト本文のパラメーターを使った複雑なクエリに POST を使用します。必ずメソッドを確認してください。

1. GET エンドポイントでは、パラメーターをクエリ文字列で渡します
2. POST エンドポイントでは、Content-Type: application/json を指定し、パラメーターを JSON 本文で渡します

よくあるユースケース

エンドポイントの選び方については、目的別のガイダンスを use-cases.md で確認してください。

1. コントラクトアドレスから DEX トークンの価格を取得する
2. 名前からトークンのコントラクトアドレスを検索する
3. 複数のトークンの価格を一度に取得する
4. 取引前にトークンのセキュリティを確認する
5. トークンの流動性プールを検索する
6. トレンド入りしている DEX トークンを検索する
7. 本日の DEX 値上がり率上位銘柄を検索する
8. 新規上場トークンを検索する
9. ラグプルの可能性を検出する（流動性の引き上げ）
10. トークンの最近の取引を取得する
11. 対応ネットワークと DEX を取得する
12. ミームコインを取得する

API 概要

エンドポイント	メソッド	説明	リファレンス
/v1/dex/token	GET	プラットフォーム／アドレスによるトークン詳細	tokens.md
/v1/dex/token/price	GET	トークンの最新 DEX 価格	tokens.md
/v1/dex/token/price/batch	POST	複数トークンの価格を一括取得	tokens.md
/v1/dex/token/pools	GET	トークンの流動性プール	tokens.md
/v1/dex/token-liquidity/query	GET	時系列のトークン流動性	tokens.md
/v1/dex/tokens/batch-query	POST	トークンのメタデータを一括取得	tokens.md
/v1/dex/tokens/transactions	GET	最近の DEX 取引	tokens.md
/v1/dex/tokens/trending/list	POST	トレンド入りしている DEX トークン	tokens.md
/v4/dex/pairs/quotes/latest	GET	DEX ペアの最新価格情報	pairs.md
/v4/dex/spot-pairs/latest	GET	DEX 現物ペアの一覧	pairs.md
/v1/dex/platform/list	GET	対応 DEX プラットフォームの一覧	platforms.md
/v1/dex/platform/detail	GET	プラットフォームの詳細	platforms.md
/v1/dex/search	GET	DEX トークン／ペアを検索	platforms.md
/v1/dex/gainer-loser/list	POST	DEX 値上がり率／値下がり率上位銘柄	discovery.md
/v1/dex/liquidity-change/list	GET	流動性に変化があったトークン	discovery.md
/v1/dex/meme/list	POST	DEX 上のミームトークン	discovery.md
/v1/dex/new/list	POST	新たに発見された DEX トークン	discovery.md
/v1/dex/security/detail	GET	トークンのセキュリティ／リスク指標	security.md

よくあるワークフロー

DEX トークン情報を取得する

1. トークンを検索する：/v1/dex/search?keyword=PEPE
2. トークンの詳細を取得する：/v1/dex/token?network_slug=ethereum&contract_address=0x...
3. セキュリティリスクを確認する：/v1/dex/security/detail?network_slug=ethereum&contract_address=0x...

トークンの流動性を分析する

1. トークンのプールを取得する：/v1/dex/token/pools?network_slug=ethereum&contract_address=0x...
2. 流動性の履歴を取得する：/v1/dex/token-liquidity/query?network_slug=ethereum&contract_address=0x...

トレンド入りしているトークンを検索する

1. トレンド入りしているトークンを取得する：フィルターを指定して POST /v1/dex/tokens/trending/list を呼び出します
2. 値上がり率／値下がり率上位銘柄を取得する：POST /v1/dex/gainer-loser/list を呼び出します
3. 新しいトークンを検索する：POST /v1/dex/new/list を呼び出します

DEX のアクティビティを監視する

1. 最近のトランザクションを取得します：/v1/dex/tokens/transactions?network_slug=ethereum&contract_address=0x...
2. ペアの価格を取得します：/v4/dex/pairs/quotes/latest?network_slug=ethereum&contract_address=0x...

主なパラメーター

ほとんどの DEX エンドポイントでは、次のパラメーターが必要です。

1. network_slug または platform_crypto_id：ブロックチェーンを識別します（ethereum、solana、bsc）
2. contract_address：トークンのオンチェーンコントラクトアドレス

有効なネットワークスラッグとプラットフォーム ID を取得するには、/v1/dex/platform/list を使用してください。

エラー処理

コード	意味
400	不正なリクエスト（パラメーターが無効です）
401	認証されていません（API キーが無効または不足しています）
403	アクセスが拒否されました（エンドポイントがご利用プランに含まれていません）
429	レート制限を超過しました
500	サーバーエラー

エラーレスポンスの例：

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

レート制限

レート制限は API プランによって異なります。レスポンスヘッダーを確認してください。

1. X-CMC_PRO_API_KEY_CREDITS_REMAINING：残りのクレジット
2. X-CMC_PRO_API_KEY_CREDITS_RESET：リセット時刻

レスポンス形式

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

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