jiayaoqijia 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:
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/listwith 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_slugorplatform_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:
{
"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 leftX-CMC_PRO_API_KEY_CREDITS_RESET: Reset timestamp
Response Format
All responses follow this structure:
{
"status": {
"timestamp": "2024-01-15T12:00:00.000Z",
"error_code": 0,
"error_message": null
},
"data": { ... }
}