mcpField
C
cmc-x402

cmc-x402

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

cmc-x402 について

cmc-x402は、x402決済でCoinMarketCapの暗号資産やDEXの市場データを取得するスキルです。REST APIと、USDC決済に対応したMCPエンドポイントを扱います。

主な機能

  1. 01コイン価格と一覧の取得
  2. 02DEXトークンの検索
  3. 03DEXペア取引データの取得
  4. 04x402によるリクエスト決済
  5. 05MCPツールの自動検出

活用シーン

  1. 01ポートフォリオ用の価格取得
  2. 02時価総額順のコイン一覧作成
  3. 03キーワードによるDEXトークン検索
  4. 04DEXペアの取引データ監視

MCP 対応

Streamable HTTP対応のMCPエンドポイント https://mcp.coinmarketcap.com/x402/mcp を提供します。REST APIに対応するツールを公開し、自動検出とx402決済をサポートします。

インストール

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

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

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

同梱ファイルreferences/endpoints.mdreferences/payment-details.md

詳細

CoinMarketCap x402

x402 プロトコルを利用した、リクエストごとに支払う暗号資産マーケットデータです。オンチェーンの USDC 決済により、CoinMarketCap のエンドポイントにすぐにアクセスできます。API キーやサブスクリプションは不要です。

x402 とは？

x402 は、HTTP 経由でステーブルコインの決済を自動化する、Coinbase が開発したオープンな決済プロトコルです。API キーを管理する代わりに、Base 上でリクエストごとに $0.01 USDC を支払います。x402 クライアントライブラリが決済の署名を自動的に処理します。

詳細はこちら：https://docs.x402.org

前提条件

x402 エンドポイントを使用する前に、以下を用意してください。

  1. Node.js 18+ および npm のインストール
  2. Base ネットワークのウォレット（自分で管理する秘密鍵が必要です）
  3. リクエストの支払いに使う Base 上の USDC（リクエストごとに $0.01）
  4. ガス代として使う 少量の Base 上の ETH

ユースケース

特定のコインの現在価格を取得する： /x402/v3/cryptocurrency/quotes/latest を symbol または id パラメーターとともに使用します。 例：ポートフォリオトラッカーで BTC と ETH の価格を取得します。

上位の暗号資産を一覧表示する： /x402/v3/cryptocurrency/listing/latest を limit パラメーターとともに使用します。 例：時価総額順に上位 100 件のコインを表示します。

DEX トークンを検索する： /x402/v1/dex/search を keyword パラメーターとともに使用します。 例：コントラクトアドレスがわからないときに、名前からミームコインを探します。

DEX ペアの取引データを取得する： /x402/v4/dex/pairs/quotes/latest をペアアドレスとともに使用します。 例：特定の Uniswap プールの流動性と取引量を監視します。

AI エージェントによるデータアクセス： https://mcp.coinmarketcap.com/x402/mcp の MCP エンドポイントを使用します。 例：Claude やその他の LLM が、自動決済でリアルタイムの暗号資産データを取得できるようにします。

クイックスタート

x402 TypeScript SDK をインストールします。

npm install @x402/axios @x402/evm viem

自動決済でデータを取得します。

import { createX402AxiosClient } from "@x402/axios";
import { ExactEvmScheme, toClientEvmSigner } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";
import { createPublicClient, http } from "viem";
import { base } from "viem/chains";

// SECURITY: Never hardcode private keys in source code.
// Use environment variables: process.env.PRIVATE_KEY
// For production, use a dedicated hot wallet with limited funds.
const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const publicClient = createPublicClient({ chain: base, transport: http() });
const signer = toClientEvmSigner(account, publicClient);

const client = createX402AxiosClient({
  schemes: [new ExactEvmScheme(signer)],
});

const response = await client.get(
  "https://pro.coinmarketcap.com/x402/v3/cryptocurrency/quotes/latest",
  { params: { symbol: "BTC,ETH" } }
);

console.log(response.data);

エンドポイント

ベース URL：https://pro.coinmarketcap.com

エンドポイントパス用途
価格情報/x402/v3/cryptocurrency/quotes/latest特定のコインの現在価格
一覧/x402/v3/cryptocurrency/listing/latest時価総額上位のコイン
DEX 検索/x402/v1/dex/searchキーワードによる DEX トークンの検索
DEX ペア/x402/v4/dex/pairs/quotes/latestDEX ペアの取引データ

標準の CMC Pro API のすべてのパラメーターを x402 エンドポイントで使用できます。すべてのパラメーターについては、endpoints.md を参照してください。

AI エージェント向け MCP

x402 MCP エンドポイントを使うと、AI エージェントは自動決済で CMC データにアクセスできます。

接続 URL：

https://mcp.coinmarketcap.com/x402/mcp

トランスポート： Streamable HTTP（POST）

x402 対応の HTTP トランスポートを備えた任意の MCP クライアントで接続できます。サーバーは REST エンドポイントと同じツールを公開し、ツールの自動検出に対応しています。

料金

Base 上でリクエストごとに $0.01 USDC（チェーン ID：8453）。

データの配信に成功した場合にのみ決済が発生します。リクエストに失敗した場合、決済は行われません。

参考資料

  • endpoints.md - すべてのエンドポイントのパラメーター一覧
  • payment-details.md - 402 レスポンス形式、コントラクトアドレス、手動での統合

リソース

コメント

Markdown 対応