Smart Routing

Every market has a central limit order book and multiple liquidity pools. The smart router splits each trade across all available venues to maximize output — atomically, in a single operation.

Pool Selection

The router selects the top pools (up to 3) ranked by quote-side reserve depth. To qualify, a pool must have active liquidity and meet a configurable minimum quote reserve threshold. Pools that don't qualify cannot be routed to — all swap specs are validated against the viable set.

Quoting

Before executing, call quote_order — a free, read-only query that returns the optimal split: total output, fee breakdown, per-venue allocations, and price impact.

quote_order(side, amount, ?limit_tick, ?slippage_bps)
  → QuoteResult { output_amount, venue_breakdown, pool_swaps, book_order, ... }

The quote returns the routing plan as structured data (pool_swaps and book_order) that you pass directly into create_orders or pass_through_trade for execution.

For the full shape of QuoteResult and its fields, see the Spot API reference.

Price Protection

limit_tick (optional) is the hard price boundary. The router will not fill any portion of your order beyond this tick — both at quote time and execution time. slippage_bps (optional) constrains max slippage in basis points. Either, both, or neither can be supplied.