Skip to main content

​
GET /v2/dex/search

Search for trading pairs across all decentralized exchanges on every chain. Cross-DEX pair search across all chains and protocols. Returns price, volume, liquidity, and price change data.

​
Query Parameters

​
q
string
required
Search query — token name, symbol, or contract address. Examples: PEPE, SOL, 0x6982508145454ce325ddbe47a25d4ec3d2311933.

​
Example

curl "https://api.crypton.dev/v2/dex/search?q=PEPE" \
  -H "X-API-Key: YOUR_API_KEY"
Response
{
  "status": "ok",
  "timestamp": 1711670400000,
  "data": {
    "pairs": [
      {
        "chain": "ethereum",
        "dex": "uniswap",
        "base_token": "PEPE",
        "base_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
        "quote_token": "WETH",
        "price_usd": 0.00001234,
        "volume_24h": 125000000.0,
        "liquidity_usd": 85000000.0,
        "fdv": 5200000000.0,
        "pair_address": "0xA43fe16908251ee70EF74718545e4FE6C5cCEc9f",
        "url": "https://dexscreener.com/ethereum/0xA43fe16908251ee70EF74718545e4FE6C5cCEc9f",
        "price_change_5m": -0.12,
        "price_change_1h": 1.5,
        "price_change_24h": -3.2
      }
    ],
    "count": 30
  }
}

​
Response Fields

​
data.pairs
array

​
Data Source

Data Source — Aggregated DEX pair index across all chains Searches across ALL DEXes on every chain. No chain filter needed; results span all chains automatically.
Rate limits apply to pair search. Avoid rapid-fire requests. Results are sorted by relevance.

​
Live Testing

# Search by token symbol
curl -s "https://api.crypton.dev/v2/dex/search?q=WETH" -H "X-API-Key: YOUR_KEY" | jq '.data.count'

# Search by contract address
curl -s "https://api.crypton.dev/v2/dex/search?q=0x6982508145454ce325ddbe47a25d4ec3d2311933" \
  -H "X-API-Key: YOUR_KEY" | jq '.data.pairs[:3]'

​
Error Responses

StatusConditionBody
400Missing q parameter{"status": "error", "message": "Missing required query parameter 'q'"}
502DEX data temporarily unavailable{"status": "error", "message": "dex/search: upstream request failed"}