// Introduction
RouterX Documentation
RouterX is an on-chain DEX aggregator built for operators who optimize the trade itself — on-chain quotes with no API rate limits, routes you can control, and quotes that match executable paths across EVM.
What is RouterX#
Most aggregators are kitchen-sink products that hide routing behind a hosted API. RouterX takes the opposite approach: the router lives on-chain, quotes are computed against real adapter liquidity, and the quote you read is the path you execute. It is designed for liquidation bots, arbitrage searchers, and treasury desks that need deterministic, gas-aware routing they can reason about.
- No API rate limits. Quote as often as your strategy requires — quoting reads on-chain state directly.
- Gas-aware routing.Routes are scored net of gas, so the "best" route reflects realized profit, not headline output.
- Quote = execution. The returned route encodes the exact calldata you settle with.
- Adapter architecture. Each venue is an isolated adapter, so integrations stay auditable and composable.
Start building#
Pick the surface that matches how you want to integrate.
Design principles#
Every part of RouterX follows from a single idea: the operator, not the aggregator, owns the trade. That shapes the API surface, the SDK ergonomics, and the on-chain contract design described throughout these docs.
Executable by default
A RouterX quote is only considered valid if it can be settled at the block it was quoted against. Stale or non-executable routes are never returned.Your first call#
The fastest way to see RouterX work is a single quote request. This returns the best gas-adjusted route for a 1 WETH → USDC swap:
curl "https://api.routerx.exchange/v1/quote?chainId=1&tokenIn=0xC02a...WETH&tokenOut=0xA0b8...USDC&amountIn=1000000000000000000"Continue with the Quickstart to install the SDK and settle a route on-chain.