Overview

Understanding the four swap routing strategies

DexAggregator automatically detects and implements the optimal swap type based on liquidity distribution and routing efficiency. Understanding these types helps you interpret the routing logic and optimize your integrations.

The Four Swap Types

Type	Structure	Use Case	Complexity
Simple	TokenA → [DEX] → TokenB	Direct swap via single DEX	Low
Batch	Multiple DEXes in parallel	Split liquidity for better rates	Medium
Multi-Hop	Sequential swaps through tokens	No direct liquidity pool	Medium
Parallel Multi-Hop	Parallel routes with internal hops	Complex routing optimization	High

Quick Comparison

Simple Swap

WBNB ─────[PancakeSwapV3]────→ USDT
      (100% of liquidity)

When used: Direct pool exists with sufficient liquidity

Batch Swap

WBNB ─────[PancakeSwapV3 60%]────→ USDT
     └────[UniswapV2 40%]─────────┘

When used: Multiple pools offer competitive rates

Multi-Hop Swap

TokenA ─[DEX1]→ WBNB ─[DEX2]→ USDT

When used: No direct TokenA-USDT pool exists

Parallel Multi-Hop

         ┌─[DEX1]→ WBNB ─[DEX2]→┐
TokenA ──┤                        ├→ USDT
         └─[DEX3]→ BUSD ─[DEX4]→ ┘

When used: Complex routing through multiple intermediate paths

Automatic Detection

The API automatically selects the optimal swap type:

1. Analyze Route Structure - Examine KyberSwap's routing recommendation

2. Calculate Split Ratios - Determine liquidity distribution

3. Select Swap Type - Choose the most efficient encoding

4. Generate Calldata - Encode parameters for smart contract

Detection Logic

function detectSwapType(route) {
  if (route.swaps.length === 1) {
    if (route.swaps[0].poolLength === 1) {
      return "simple";  // Single pool
    } else {
      return "multihop";  // Single path, multiple pools
    }
  } else {
    // Multiple swaps - check for internal hops
    const hasInternalHops = route.swaps.some(s => s.poolLength > 1);
    return hasInternalHops ? "parallel_multihop" : "batch";
  }
}

Response Field: swapType

Every response includes the detected swap type:

{
  "code": 0,
  "message": "success",
  "data": {
    "swapType": "batch",
    "routeInfo": {
      "routes": [...]
    }
  }
}

Gas Costs by Type

Swap Type	Typical Gas	Description
Simple	100k-150k	Lowest gas cost
Batch	150k-250k	Scales with number of splits
Multi-Hop	200k-300k	Depends on hop count
Parallel Multi-Hop	300k-500k	Most complex, highest gas

Gas Optimization

Gas costs are estimates. Actual costs depend on:

• Number of token swaps

• DEX protocol complexity (V2 vs V3)

• Current network congestion

Choosing Swap Types

When Simple is Best

• ✅ Direct liquidity pool exists

• ✅ Single pool has sufficient depth

• ✅ Lowest gas cost priority

When Batch is Better

• ✅ Multiple competitive price sources

• ✅ Large swap amounts

• ✅ Price improvement > gas cost

When Multi-Hop is Needed

• ✅ No direct pool available

• ✅ Intermediate token has deep liquidity

• ✅ Common routing pattern (e.g., via WETH)

When Parallel Multi-Hop Wins

• ✅ Very large swap amounts

• ✅ Single path has insufficient depth

• ✅ Multiple intermediate routing options

Examples by Token Pair

Popular Pairs (Simple/Batch)

WBNB ↔ USDT  → Often Simple (direct pool)
ETH ↔ USDC   → Often Simple (direct pool)
WBNB ↔ BUSD  → May use Batch (multiple pools)

Exotic Pairs (Multi-Hop)

TokenX → WBNB → USDT  (2-hop)
TokenY → ETH → USDC   (2-hop)

Large Amounts (Parallel Multi-Hop)

$100K+ swaps often trigger parallel routing
Multiple paths reduce price impact

Route Visualization

The routeInfo field provides detailed routing breakdown:

Simple Swap

{
  "swapType": "simple",
  "routeInfo": {
    "routes": [{
      "adapter": "PancakeSwapV3",
      "percentage": 100,
      "path": {
        "tokens": ["0xTokenA", "0xTokenB"]
      }
    }]
  }
}

Batch Swap

{
  "swapType": "batch",
  "routeInfo": {
    "routes": [
      {
        "adapter": "PancakeSwapV3",
        "percentage": 60,
        "path": {"tokens": ["0xTokenA", "0xTokenB"]}
      },
      {
        "adapter": "UniswapV2",
        "percentage": 40,
        "path": {"tokens": ["0xTokenA", "0xTokenB"]}
      }
    ]
  }
}

Multi-Hop Swap

{
  "swapType": "multihop",
  "routeInfo": {
    "routes": [{
      "adapter": "Multiple",
      "percentage": 100,
      "path": {
        "tokens": ["0xTokenA", "0xWBNB", "0xTokenB"],
        "adapters": ["PancakeSwapV3", "UniswapV2"]
      }
    }]
  }
}

Understanding Percentages

In Batch and Parallel Multi-Hop swaps, percentages indicate liquidity split:

60% via PancakeSwapV3 = 0.6 * amountIn
40% via UniswapV2      = 0.4 * amountIn

The smart contract handles the splitting automatically based on executorData.

Best Practices

Optimization Tips

1. Don't force swap types - Let the API choose automatically

2. Monitor gas costs - Complex types may not justify price improvement

3. Set appropriate slippage - Multi-hop swaps may have higher slippage

4. Test exotic pairs - Understand routing before large swaps

Important Notes

• Swap type is determined by KyberSwap's routing algorithm

• Custom routes allow manual swap type selection

• More complex types don't always mean better rates

• Gas costs scale with routing complexity

Deep Dive Pages

Learn more about each swap type:

• Simple Swap - Direct single-DEX swaps

• Batch Swap - Parallel liquidity splitting

• Multi-Hop Swap - Sequential routing

• Parallel Multi-Hop - Advanced parallel routing

Related Topics

• Build Route API - Automatic routing

• Custom Route API - Manual routing

• Gas Optimization Guide