DEX API Documentation

{
  "minSpread": 0.5,
  "chains": ["ethereum", "arbitrum", "solana"],
  "cexExchanges": ["binance", "bybit", "okx"],
  "symbols": ["ETHUSDC", "SOLUSDC"],
  "includeDex": true
}

class DexScannerAPI {
  private baseURL: string;

  constructor(baseURL = 'https://api.example.com') {
    this.baseURL = baseURL;
  }

  async getRoutes(minSpread?: number): Promise<RoutesResponse> {
    const params = new URLSearchParams();
    if (minSpread) params.set('minSpread', minSpread.toString());

    const response = await fetch(this.baseURL + '/api/dex/routes?' + params.toString());
    if (!response.ok) throw new Error('HTTP ' + response.status);
    return response.json();
  }

  async getSymbol(symbol: string): Promise<SymbolResponse> {
    const response = await fetch(this.baseURL + '/api/dex/symbol/' + symbol);
    if (response.status === 404) throw new Error('Symbol ' + symbol + ' not found');
    if (!response.ok) throw new Error('HTTP ' + response.status);
    return response.json();
  }
}

const api = new DexScannerAPI();
const routes = await api.getRoutes(0.5);
const symbolData = await api.getSymbol('ETH');

import requests
from typing import Optional, Dict, Any

class DexScannerAPI:
    def __init__(self, base_url: str = "https://api.example.com"):
        self.base_url = base_url
        self.session = requests.Session()

    def get_routes(self, min_spread: Optional[float] = None) -> Dict[str, Any]:
        params = {}
        if min_spread:
            params['minSpread'] = min_spread

        response = self.session.get(
            f"{self.base_url}/api/dex/routes",
            params=params
        )
        response.raise_for_status()
        return response.json()

    def get_symbol(self, symbol: str) -> Dict[str, Any]:
        response = self.session.get(
            f"{self.base_url}/api/dex/symbol/{symbol}"
        )
        if response.status_code == 404:
            raise ValueError(f"Symbol {symbol} not found")
        response.raise_for_status()
        return response.json()

api = DexScannerAPI()
routes = api.get_routes(min_spread=0.5)
symbol_data = api.get_symbol("ETH")

# Get all DEX routes
curl -s "https://api.example.com/api/dex/routes" | jq '.rows[0:5]'

# Get symbol data
curl -s "https://api.example.com/api/dex/symbol/ETH" | jq '.bestRoute'

# Get paginated symbols
curl -s "https://api.example.com/api/dex/symbols?limit=10&offset=0" | jq '.symbols'

# Get CEX-above opportunities
curl -s "https://api.example.com/api/dex/routes/cex-above?minVolume=500000" | jq '.count'