Routing & gas
Understand direct paths, multi-hop routes, splits and gas-adjusted ranking.
Bounded exact-input search
Path searches direct and multi-hop paths and can split input across branches. Integer allocation preserves input remainders. The search is bounded by hop, split, path and quote-call budgets; it does not claim a global best price.
| Limit | Current value |
|---|---|
| Maximum hops per branch | 3 |
| Maximum split branches | Fast: 2; verified: up to 3 |
| Candidate path limit | Fast: starts at 6, expands up to 32 |
| Execution search quote calls | 240; local calculations in fast mode |
| Additional gas pricing quote calls | Fast: 0; verified: up to 32 |
| Quote lifetime | At most 15 seconds; also bounded by snapshot age |
Fast mode tries splits when potential output improvement can pay the extra gas and economic threshold, then refines the allocation locally. Branches never independently reuse the same pool. Read /api/v1/config for deployed values. coverage.complete is currently always false. coverage.budgetExhausted and quoteFailures describe the search that actually completed, not the whole market.
Rank by estimated economic output
gasCostInOutput = ceil(gasEstimate × gasPrice × numerator / denominator)
netAmountOut = amountOut − gasCostInOutputFor HYPE or WHYPE output, the conversion is 1:1 in base units. Fast mode shares one locally calculated reference per snapshot, with median/outlier checks, source block and confidence metadata. Verified recovery does not probe pools to calculate network fees; non-native outputs use output-only ranking. If a cached conversion is unavailable or observations disagree, fast mode also falls back to output-only ranking.
Quote gas is heuristic until sender-specific preflight. Pool-derived gas conversion is an indicative spot estimate, not an execution oracle or a manipulation-proof price. Check rankingBasis, gasConversion and warnings.
Read the evidence correctly
Local math, fork tests and isolated settlement tests check specific models and scenarios. They do not establish mainnet availability, independent audit status, sustained network latency or a universal price advantage. Path publishes coverage and simulation status so integrations can distinguish those claims.