This endpoint allows users to preview the results of a multi-hop swap through a sequence of liquidity pools without executing the transaction. It calculates expected outputs, fees, and price impacts across the entire route.

Simulation Process

1. Load all pools in the route into memory
2. Validate asset pairs match between consecutive hops
3. Simulate each swap sequentially using current reserves
4. Calculate cumulative fees and price impacts
5. Apply slippage protection to determine viability
6. Return detailed breakdown without modifying state

Multi-Hop Calculation

The simulation executes virtually through each pool:

• Each hop’s output becomes the next hop’s input
• Fees are deducted at each step, compounding through route
• Price impact accumulates across all hops
• Final output reflects all fees and slippage

Route Validation

Before simulation, the system validates:

• Minimum 2 hops required (use regular swap for single hop)
• All pools exist and have sufficient liquidity
• Asset pairs are correctly chained (hop[n].output = hop[n+1].input)
• Maximum slippage tolerance is reasonable (0-100%)

Price Impact Analysis

The simulation provides detailed impact metrics:

• Per-hop impact: Price movement in each individual pool
• Cumulative impact: Total price degradation across route
• Warning threshold: Alerts when impact exceeds 5%
• Impact increases with trade size relative to pool liquidity

Fee Breakdown

Simulation calculates all fees separately:

• LP fees: Fees paid to liquidity providers at each pool
• Host fees: Platform fees for each pool’s host
• Total fees: Sum of all fees across the route
• Fees compound (each reduces next hop’s input amount)

Execution Price

The execution price represents:

• Effective exchange rate: output_amount / input_amount
• Includes all fees and price impacts
• Comparable to direct pair pricing for arbitrage detection

Use Cases

Route simulation is useful for:

• Finding optimal paths between assets without direct pairs
• Comparing routes for best execution
• Estimating costs before committing funds
• Detecting arbitrage opportunities
• Understanding fee impact on large trades

No Authentication Required

Simulations are read-only operations that don’t modify pool state or require authentication. Anyone can simulate routes.

Arguments

• hops - Ordered sequence of pools and assets defining the route
• amount_in - Initial amount to swap through the route
• max_route_slippage_bps - Maximum acceptable slippage in basis points

Returns

• 200 OK with detailed simulation results and per-hop breakdown
• 400 Bad Request if route validation fails or pools don’t exist
• 500 Internal Server Error if simulation calculation fails