Skills cmc-api-dex

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/bryan-cmc/cmc-api-dex" ~/.claude/skills/clawdbot-skills-cmc-api-dex && rm -rf "$T"

manifest: skills/bryan-cmc/cmc-api-dex/SKILL.md

source content

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/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:

{
  "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:

{
  "status": {
    "timestamp": "2024-01-15T12:00:00.000Z",
    "error_code": 0,
    "error_message": null
  },
  "data": { ... }
}