mcpField
C
cmc-api-dex

cmc-api-dex

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

关于 cmc-api-dex

cmc-api-dex 是介绍 CoinMarketCap DEX API 的 Skill，面向查询链上代币数据的开发者，涵盖接口选择、认证和常见查询流程。

主要功能

  1. 01查询代币价格、详情与交易
  2. 02查找代币流动性池及历史
  3. 03发现热门、新上线及涨跌代币
  4. 04查看代币安全风险信号
  5. 05说明 API 认证、请求方式与错误

适用场景

  1. 01按合约地址查询 DEX 代币
  2. 02检查代币流动性及变化
  3. 03筛选热门或新发现代币
  4. 04查看交易活动与安全信号

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/cmc-api-dex确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
discovery.md
pairs.md
platforms.md
security.md
tokens.md
use-cases.md

详细介绍

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 端点在 JSON 请求体中传递参数，并使用 Content-Type: application/json

常见用例

请参阅 use-cases.md，了解根据目标选择端点的指南：

  1. 根据合约地址获取 DEX 代币价格
  2. 根据名称查找代币的合约地址
  3. 一次获取多个代币的价格
  4. 交易前检查代币安全性
  5. 查找代币的流动性池
  6. 查找热门 DEX 代币
  7. 查找今日涨幅最大的 DEX 代币
  8. 查找新发行的代币
  9. 检测潜在的 Rug Pull（移除流动性）
  10. 获取代币的近期交易
  11. 获取支持的网络和 DEX
  12. 获取 Meme 币

API 概览

EndpointMethodDescriptionReference
/v1/dex/tokenGET根据平台/地址获取代币详情tokens.md
/v1/dex/token/priceGET获取代币最新 DEX 价格tokens.md
/v1/dex/token/price/batchPOST批量获取代币价格tokens.md
/v1/dex/token/poolsGET获取代币的流动性池tokens.md
/v1/dex/token-liquidity/queryGET获取代币随时间变化的流动性tokens.md
/v1/dex/tokens/batch-queryPOST批量获取代币元数据tokens.md
/v1/dex/tokens/transactionsGET获取近期 DEX 交易tokens.md
/v1/dex/tokens/trending/listPOST获取热门 DEX 代币tokens.md
/v4/dex/pairs/quotes/latestGET获取最新 DEX 交易对报价pairs.md
/v4/dex/spot-pairs/latestGET获取 DEX 现货交易对列表pairs.md
/v1/dex/platform/listGET列出支持的 DEX 平台platforms.md
/v1/dex/platform/detailGET获取平台详情platforms.md
/v1/dex/searchGET搜索 DEX 代币/交易对platforms.md
/v1/dex/gainer-loser/listPOST获取涨幅/跌幅最大的 DEX 代币discovery.md
/v1/dex/liquidity-change/listGET获取流动性发生变化的代币discovery.md
/v1/dex/meme/listPOST获取 DEX 上的 Meme 代币discovery.md
/v1/dex/new/listPOST获取新发现的 DEX 代币discovery.md
/v1/dex/security/detailGET获取代币安全/风险信号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：代币的链上合约地址

使用 /v1/dex/platform/list 获取有效的网络 slug 和平台 ID。

错误处理

代码含义
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": { ... }
}

评论

支持 Markdown