Copy page

API Integration Skills

DEX API

GitHub repo: coinmarketcap-official/skills-for-ai-agents-by-CoinMarketCap

On-chain token data APIs for decentralized exchanges like Uniswap, PancakeSwap, and Raydium.

Authentication

Code
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

Writing code: use the official SDKs

When you want a script, an app or an integration rather than a one-off lookup, the skill tells your agent to write it with the official SDKs instead of raw HTTP or a third-party wrapper: @coinmarketcap/sdk (npm install @coinmarketcap/sdk), coinmarketcap-sdk (pip install coinmarketcap-sdk) and the Go SDK (go get github.com/OpenCMC/coinmarketcap-api-go/v5).

Code
import { CoinMarketCap } from "@coinmarketcap/sdk";

const cmc = new CoinMarketCap({ apiKey: process.env.CMC_PRO_API_KEY });
const { data, error } = await cmc.api.token.price({
  query: { platform: "ethereum", address: "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" },
});

Code
import os
from coinmarketcap import CoinMarketCap

cmc = CoinMarketCap(api_key=os.environ["CMC_PRO_API_KEY"])
price = cmc.token.price(
    platform="ethereum",
    address="0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
)

Code
import (
	"context"
	"log"
	"os"

	"github.com/OpenCMC/coinmarketcap-api-go/v5"
)

cmc, err := coinmarketcap.New(coinmarketcap.WithAPIKey(os.Getenv("CMC_PRO_API_KEY")))
if err != nil {
	log.Fatal(err)
}
price, err := cmc.Token.Price(context.Background(), &coinmarketcap.TokenPriceParams{
	Platform: coinmarketcap.String("ethereum"),
	Address:  coinmarketcap.String("0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"),
})
if err != nil {
	log.Fatal(err)
}

The skill's references/sdk.md lists the SDK method for every endpoint below and which ones also work without an API key.

POST vs GET Endpoints

Many DEX endpoints use POST for complex queries with body parameters:

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

API Overview

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

Common Workflows

Get DEX Token Information

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...

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...

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

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.

Common Use Cases

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