Order types: route
What it does
Section titled “What it does”A route trades A for C through B, for example ERG to tUSE to tBTC. It uses two markets in one transaction, so either both legs happen or neither does. You set one minimum payout, in C.
You never end up holding B halfway: an order that could leave you stuck in the middle wasn’t allowed.
When to use it
Section titled “When to use it”- When there’s no market between your two coins, but each has a market with a third.
- When a two-step path pays more than a direct market.
What you pay
Section titled “What you pay”- Each market’s order fee, taken in its own leg. See fees.
- One execution fee, within your cap, for the whole route: both markets fill in one transaction. Kadia’s settler charges only what the fill costs.
What can go wrong
Section titled “What can go wrong”- All or nothing means it may wait. If either leg can’t fill at a price that pays your minimum, the whole route waits. If it never fills before expiry, it’s refunded.
- Two markets, two moves. Each leg moves its own pool’s price and pays its own pool’s fee, so the route’s price is the two combined.
- Bridged tokens in the middle carry bridge risk: a Rosen token is worth what Rosen’s bridge custody makes it worth. Look-alike tokens are left out of routing.
- A pause on either market stops the whole route. The refund still works.
- Cancelling a route in the app depends on the DEX service supporting it. Until it does, My orders says so, and the way back is the refund once the route expires.
Technical details
Sources: kadia-dex docs/guide/how-it-works.md, docs/guide/fees.md and the order-type decisions in docs/decisions/ at commit 7ce1595 (7ce159587dc8c0bd78d6a5fbe0f7f8e7dde3920e).