mcpField
C
cmc-x402

cmc-x402

github.com/opencmc数据与数据库75103 次安装5 天前更新
代码仓库

关于 cmc-x402

cmc-x402 是通过 x402 付费查询 CoinMarketCap 加密货币及 DEX 行情数据的技能，涵盖 REST 接口和支持 USDC 自动支付的 MCP 接口。

主要功能

  1. 01查询币种报价与列表
  2. 02搜索 DEX 代币
  3. 03获取 DEX 交易对数据
  4. 04通过 x402 按请求付费
  5. 05自动发现 MCP 工具

适用场景

  1. 01获取投资组合所需币价
  2. 02按市值排列加密货币
  3. 03按关键词搜索 DEX 代币
  4. 04监控 DEX 交易对行情

MCP 相关

提供基于 Streamable HTTP 的 MCP 接口 https://mcp.coinmarketcap.com/x402/mcp，公开与 REST 接口对应的工具，并支持自动发现和 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 是由 Coinbase 开发的开放支付协议，可通过 HTTP 自动进行稳定币支付。无需管理 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，用于支付 Gas 费

使用场景

获取特定币种的当前价格： 使用 /x402/v3/cryptocurrency/quotes/latest，并传入 symbol 或 id 参数。 示例：为投资组合追踪器获取 BTC 和 ETH 的价格。

列出热门加密货币： 使用 /x402/v3/cryptocurrency/listing/latest，并传入 limit 参数。 示例：按市值排名展示前 100 种币。

搜索 DEX 代币： 使用 /x402/v1/dex/search，并传入 keyword 参数。 示例：不知道合约地址时，按名称查找 memecoin。

获取 DEX 交易对数据： 使用 /x402/v4/dex/pairs/quotes/latest，并传入交易对地址。 示例：监控特定 Uniswap 池的流动性和交易量。

AI Agent 数据访问： 使用 MCP 端点 https://mcp.coinmarketcap.com/x402/mcp。 示例：让 Claude 或其他大模型通过自动付款获取实时加密货币数据。

快速开始

安装 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/latest获取 DEX 交易对数据

标准 CMC Pro API 的所有参数均适用于 x402 端点。完整参数参考请参阅 endpoints.md。

面向 AI Agent 的 MCP

x402 MCP 端点支持 AI Agent 通过自动付款访问 CMC 数据。

连接 URL：

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

传输方式： Streamable HTTP（POST）

使用任何支持 x402 的 HTTP 传输方式的 MCP 客户端进行连接。该服务提供与 REST 端点相同的工具，并支持自动发现工具。

定价

在 Base 上每次请求收费 0.01 美元的 USDC（Chain ID：8453）。

仅在成功交付数据后才会付款。若请求失败，则不会扣款。

参考资料

资源

评论

支持 Markdown