cmc-api-dex

Original：🇺🇸 English

Translated

API reference for CoinMarketCap DEX endpoints including token lookup, pools, transactions, trending, and security analysis. Use this skill whenever the user mentions DEX API, asks about on-chain token data, wants to look up tokens by contract address, needs security/rug risk checks, or is building DEX integrations. This is the definitive reference for CMC DEX API questions. Trigger: "DEX API", "token by contract address", "CMC security API", "liquidity pool API", "/cmc-api-dex"

2installs

Sourcecoinmarketcap-official/skills-for-ai-agents-by-coinmarketcap

Added on2026-03-18

NPX Install

npx skill4agent add coinmarketcap-official/skills-for-ai-agents-by-coinmarketcap cmc-api-dex

SKILL.md Content

View Translation Comparison →

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.

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

Base URL

https://pro-api.coinmarketcap.com

POST vs GET Endpoints

Many DEX endpoints use POST for complex queries with body parameters. Always check the method:

GET endpoints pass parameters as query strings
POST endpoints pass parameters in JSON body with
```
Content-Type: application/json
```

Common Use Cases

See use-cases.md for goal-based guidance on which endpoint to use:

Get DEX token price by contract address
Find a token's contract address by name
Get prices for multiple tokens at once
Check token security before trading
Find liquidity pools for a token
Find trending DEX tokens
Find today's biggest DEX gainers
Find newly launched tokens
Detect potential rug pulls (liquidity removal)
Get recent trades for a token
Get supported networks and DEXs
Get meme coins

API Overview

Endpoint	Method	Description	Reference
/v1/dex/token	GET	Token details by platform/address	tokens.md
/v1/dex/token/price	GET	Latest DEX price for a token	tokens.md
/v1/dex/token/price/batch	POST	Batch token prices	tokens.md
/v1/dex/token/pools	GET	Liquidity pools for a token	tokens.md
/v1/dex/token-liquidity/query	GET	Token liquidity over time	tokens.md
/v1/dex/tokens/batch-query	POST	Batch token metadata	tokens.md
/v1/dex/tokens/transactions	GET	Recent DEX transactions	tokens.md
/v1/dex/tokens/trending/list	POST	Trending DEX tokens	tokens.md
/v4/dex/pairs/quotes/latest	GET	Latest DEX pair quotes	pairs.md
/v4/dex/spot-pairs/latest	GET	DEX spot pairs listing	pairs.md
/v1/dex/platform/list	GET	List supported DEX platforms	platforms.md
/v1/dex/platform/detail	GET	Platform details	platforms.md
/v1/dex/search	GET	Search DEX tokens/pairs	platforms.md
/v1/dex/gainer-loser/list	POST	Top DEX gainers/losers	discovery.md
/v1/dex/liquidity-change/list	GET	Tokens with liquidity changes	discovery.md
/v1/dex/meme/list	POST	Meme tokens on DEX	discovery.md
/v1/dex/new/list	POST	Newly discovered DEX tokens	discovery.md
/v1/dex/security/detail	GET	Token security/risk signals	security.md

Common Workflows

Get DEX Token Information

Search for token:
```
/v1/dex/search?keyword=PEPE
```

Get token details:

/v1/dex/token?network_slug=ethereum&contract_address=0x...

Check security risks:

/v1/dex/security/detail?network_slug=ethereum&contract_address=0x...

Analyze Token Liquidity

Get token pools:

/v1/dex/token/pools?network_slug=ethereum&contract_address=0x...

Get liquidity history:

/v1/dex/token-liquidity/query?network_slug=ethereum&contract_address=0x...

Find Trending Tokens

Get trending tokens: POST
```
/v1/dex/tokens/trending/list
```
with filters
Get gainers/losers: POST
```
/v1/dex/gainer-loser/list
```
Find new tokens: POST
```
/v1/dex/new/list
```

Monitor DEX Activity

Get recent transactions:

/v1/dex/tokens/transactions?network_slug=ethereum&contract_address=0x...

Get pair quotes:

/v4/dex/pairs/quotes/latest?network_slug=ethereum&contract_address=0x...

Key Parameters

Most DEX endpoints require:

```
network_slug
```
or
```
platform_crypto_id
```
: Identifies the blockchain (ethereum, solana, bsc)
```
contract_address
```
: The token's on-chain contract address

Use

/v1/dex/platform/list

to get valid network slugs and platform IDs.

Error Handling

Code	Meaning
400	Bad request (invalid parameters)
401	Unauthorized (invalid or missing API key)
403	Forbidden (endpoint not in your plan)
429	Rate limit exceeded
500	Server error

Example error response:

json

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

Rate Limits

Rate limits depend on your API plan. Check response headers:

```
X-CMC_PRO_API_KEY_CREDITS_REMAINING
```
: Credits left
```
X-CMC_PRO_API_KEY_CREDITS_RESET
```
: Reset timestamp

Response Format

All responses follow this structure: