Back to Details

cmc-api-dex

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

CoinMarketCap DEX API

CoinMarketCap DEX API

This skill covers CoinMarketCap's DEX (Decentralized Exchange) APIs for on-chain token data. Unlike CEX endpoints, these APIs fetch data directly from blockchain DEXs like Uniswap, PancakeSwap, and Raydium.
本技能涵盖CoinMarketCap用于链上代币数据的DEX（去中心化交易所）API。与中心化交易所（CEX）端点不同，这些API直接从Uniswap、PancakeSwap和Raydium等区块链DEX获取数据。

Authentication

认证

All requests require an API key in the header:
bash
curl -X GET "https://pro-api.coinmarketcap.com/v1/dex/platform/list" \
  -H "X-CMC_PRO_API_KEY: your-api-key"
Get your API key at: https://pro.coinmarketcap.com/login
所有请求都需要在请求头中携带API密钥：
bash
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

Base URL

基础URL

https://pro-api.coinmarketcap.com
https://pro-api.coinmarketcap.com

POST vs GET Endpoints

POST与GET端点

Many DEX endpoints use POST for complex queries with body parameters. Always check the method:
  1. GET endpoints pass parameters as query strings
  2. POST endpoints pass parameters in JSON body with 
    Content-Type: application/json
许多DEX端点使用POST请求处理带有请求体参数的复杂查询。请务必确认请求方法：
  1. GET端点通过查询字符串传递参数
  2. POST端点通过JSON请求体传递参数，且需设置
    Content-Type: application/json

Common Use Cases

常见使用场景

See use-cases.md for goal-based guidance on which endpoint to use:
  1. Get DEX token price by contract address
  2. Find a token's contract address by name
  3. Get prices for multiple tokens at once
  4. Check token security before trading
  5. Find liquidity pools for a token
  6. Find trending DEX tokens
  7. Find today's biggest DEX gainers
  8. Find newly launched tokens
  9. Detect potential rug pulls (liquidity removal)
  10. Get recent trades for a token
  11. Get supported networks and DEXs
  12. Get meme coins
请查看use-cases.md获取基于目标的指导，了解应使用哪个端点：
  1. 通过合约地址获取DEX代币价格
  2. 通过代币名称查找其合约地址
  3. 一次性获取多个代币的价格
  4. 交易前检查代币安全性
  5. 查找代币的流动性池
  6. 查找热门DEX代币
  7. 查找当日涨幅最高的DEX代币
  8. 查找新上线的代币
  9. 检测潜在的跑路风险（流动性移除）
  10. 获取代币的近期交易记录
  11. 获取支持的网络和DEX平台
  12. 获取迷因币

API Overview

API概览

EndpointMethodDescriptionReference
/v1/dex/tokenGETToken details by platform/addresstokens.md
/v1/dex/token/priceGETLatest DEX price for a tokentokens.md
/v1/dex/token/price/batchPOSTBatch token pricestokens.md
/v1/dex/token/poolsGETLiquidity pools for a tokentokens.md
/v1/dex/token-liquidity/queryGETToken liquidity over timetokens.md
/v1/dex/tokens/batch-queryPOSTBatch token metadatatokens.md
/v1/dex/tokens/transactionsGETRecent DEX transactionstokens.md
/v1/dex/tokens/trending/listPOSTTrending DEX tokenstokens.md
/v4/dex/pairs/quotes/latestGETLatest DEX pair quotespairs.md
/v4/dex/spot-pairs/latestGETDEX spot pairs listingpairs.md
/v1/dex/platform/listGETList supported DEX platformsplatforms.md
/v1/dex/platform/detailGETPlatform detailsplatforms.md
/v1/dex/searchGETSearch DEX tokens/pairsplatforms.md
/v1/dex/gainer-loser/listPOSTTop DEX gainers/losersdiscovery.md
/v1/dex/liquidity-change/listGETTokens with liquidity changesdiscovery.md
/v1/dex/meme/listPOSTMeme tokens on DEXdiscovery.md
/v1/dex/new/listPOSTNewly discovered DEX tokensdiscovery.md
/v1/dex/security/detailGETToken security/risk signalssecurity.md
端点请求方法描述参考文档
/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/latestGETDEX现货交易对列表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获取涨幅/跌幅TOP的DEX代币discovery.md
/v1/dex/liquidity-change/listGET获取流动性发生变化的代币discovery.md
/v1/dex/meme/listPOST获取DEX上的迷因币discovery.md
/v1/dex/new/listPOST获取新发现的DEX代币discovery.md
/v1/dex/security/detailGET获取代币安全/风险信号security.md

Common Workflows

常见工作流

Get DEX Token Information

获取DEX代币信息

  1. Search for token: 
    /v1/dex/search?keyword=PEPE
  2. Get token details: 
    /v1/dex/token?network_slug=ethereum&contract_address=0x...
  3. Check security risks: 
    /v1/dex/security/detail?network_slug=ethereum&contract_address=0x...
  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...

Analyze Token Liquidity

分析代币流动性

  1. Get token pools: 
    /v1/dex/token/pools?network_slug=ethereum&contract_address=0x...
  2. Get liquidity history: 
    /v1/dex/token-liquidity/query?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...

Find Trending Tokens

查找热门代币

  1. Get trending tokens: POST 
    /v1/dex/tokens/trending/list
    with filters
  2. Get gainers/losers: POST 
    /v1/dex/gainer-loser/list
  3. Find new tokens: POST 
    /v1/dex/new/list
  1. 获取热门代币：POST 
    /v1/dex/tokens/trending/list
    并附带筛选条件
  2. 获取涨幅/跌幅TOP代币：POST 
    /v1/dex/gainer-loser/list
  3. 查找新代币：POST 
    /v1/dex/new/list

Monitor DEX Activity

监控DEX活动

  1. Get recent transactions: 
    /v1/dex/tokens/transactions?network_slug=ethereum&contract_address=0x...
  2. Get pair quotes: 
    /v4/dex/pairs/quotes/latest?network_slug=ethereum&contract_address=0x...
  1. 获取近期交易记录：
    /v1/dex/tokens/transactions?network_slug=ethereum&contract_address=0x...
  2. 获取交易对报价：
    /v4/dex/pairs/quotes/latest?network_slug=ethereum&contract_address=0x...

Key Parameters

关键参数

Most DEX endpoints require:
  1. network_slug
    or 
    platform_crypto_id
    : Identifies the blockchain (ethereum, solana, bsc)
  2. contract_address
    : The token's on-chain contract address
Use 
/v1/dex/platform/list
to get valid network slugs and platform IDs.
大多数DEX端点需要以下参数：
  1. network_slug
    或 
    platform_crypto_id
    ：指定区块链（如ethereum、solana、bsc）
  2. contract_address
    ：代币的链上合约地址
可调用
/v1/dex/platform/list
获取有效的网络标识和平台ID。

Error Handling

错误处理

CodeMeaning
400Bad request (invalid parameters)
401Unauthorized (invalid or missing API key)
403Forbidden (endpoint not in your plan)
429Rate limit exceeded
500Server error
Example error response:
json
{
  "status": {
    "error_code": 400,
    "error_message": "Invalid value for 'contract_address'"
  }
}
错误码含义
400请求无效（参数错误）
401未授权（API密钥无效或缺失）
403禁止访问（你的套餐不包含该端点）
429请求频率超限
500服务器错误
错误响应示例：
json
{
  "status": {
    "error_code": 400,
    "error_message": "Invalid value for 'contract_address'"
  }
}

Rate Limits

速率限制

Rate limits depend on your API plan. Check response headers:
  1. X-CMC_PRO_API_KEY_CREDITS_REMAINING
    : Credits left
  2. X-CMC_PRO_API_KEY_CREDITS_RESET
    : Reset timestamp
速率限制取决于你的API套餐。可通过响应头查看：
  1. X-CMC_PRO_API_KEY_CREDITS_REMAINING
    ：剩余调用额度
  2. X-CMC_PRO_API_KEY_CREDITS_RESET
    ：额度重置时间戳

Response Format

响应格式

All responses follow this structure:
json
{
  "status": {
    "timestamp": "2024-01-15T12:00:00.000Z",
    "error_code": 0,
    "error_message": null
  },
  "data": { ... }
}
所有响应均遵循以下结构：
json
{
  "status": {
    "timestamp": "2024-01-15T12:00:00.000Z",
    "error_code": 0,
    "error_message": null
  },
  "data": { ... }
}