# Swap

### Mosaic Swap: DEX Aggregator on Movement

Mosaic is the default DEX Aggregator on the Movement network, designed to consolidate fragmented liquidity and optimize token swaps. Through its smart routing engine, Mosaic finds the most efficient trade paths across Movement’s top decentralized exchanges and AMM protocols, ensuring users receive the best execution with minimal slippage.

#### Overview

* **Function**: Aggregates on-chain liquidity and routes trades to the most favorable execution path
* **Scope**: Connects with all major DEXs and AMM pools on Movement, including Mosaic’s native pools
* **Interface**: User-facing Swap UI + routing SDK/contract interface for integrators

***

#### Why Use a DEX Aggregator?

DEXs allow users to trade assets directly from wallets via liquidity pools. However, liquidity is often fragmented across multiple DEXs, leading to:

* Higher price impact on single pools
* Poor execution prices, especially for large trades
* Time-consuming manual price comparisons

A DEX aggregator solves this by routing trades through the most efficient combination of pools, hops, and protocols — abstracting complexity while improving outcomes.

***

#### Supported DEXs and Pools

Mosaic currently aggregates liquidity across:

* **Mosaic v2 Pools** (Uniswap v2 model)
* **Mosaic Stable Pools** (Curve-style StableSwap AMM)
* **Yuzu Finance (CLMM)**
* **Meridian**
* **RazorDEX**
* **Interest Protocol**
* **Interest Protocol (CLMM)**
* **WarpGate**
* **Liquidswap**

More integrations will be added as the Movement DeFi ecosystem grows.

***

#### Routing Engine: How It Works

Mosaic’s routing engine runs on-chain and executes each trade atomically. It operates through the following core stages:

**1. Quote Aggregation**

* Queries all integrated DEXs for current prices, liquidity, and slippage on the token pair (or intermediary pairs)
* Builds a real-time snapshot of available liquidity across all pools

**2. Route Construction**

* Constructs possible swap paths (direct and multi-hop)
* Scores each route based on:
  * **Net output** (accounting for slippage)
  * **Gas efficiency**
  * **Hop count**
  * **Liquidity robustness**

**3. Trade Execution**

* A single on-chain transaction executes the chosen path
* Powered by Mosaic’s routing contracts:
  * **Atomic execution**: Trade reverts if any leg fails
  * **Modular architecture**: Easily extensible for new DEXs
  * **Gas-optimized**: Batching, pre-approvals, route compression

***

#### Features

| Feature                     | Description                                                                |
| --------------------------- | -------------------------------------------------------------------------- |
| **Best Price Execution**    | Aggregates across all Movement DEXs to find optimal route                  |
| **Reduced Slippage**        | Splits orders across multiple pools for lower price impact                 |
| **Multi-Hop Support**       | Enables complex routes via intermediary tokens to unlock deeper liquidity  |
| **On-Chain, Non-Custodial** | Fully decentralized swap execution from user wallet                        |
| **Composability**           | Contracts and SDKs can be integrated into wallets, yield optimizers, dApps |

***

#### Upcoming Features

| Feature                 | Description                                                                     |
| ----------------------- | ------------------------------------------------------------------------------- |
| **Limit Orders**        | Allows users to set target prices and execute trades only when conditions match |
| **DCA**                 | Automate periodic token buys with optimized routing per interval                |
| **Cross-Chain Routing** | Future upgrade to bring in liquidity from outside Movement (via bridges)        |

#### Developer & Integrator Use Cases

* **Wallets** can integrate Mosaic’s routing API for better swap outcomes
* **Yield Protocols** can use it to rebalance or auto-swap rewards efficiently
* **New dApps** launching on Movement can instantly access deep liquidity by tapping into Mosaic routes

***

#### Contract Access

Mosaic exposes its router and swap logic via verified smart contracts. Integrators can:

* Query route suggestions via off-chain SDK
* Call router contracts with custom token pairs
* Use routing contracts as backend swap engines in their own interfaces

***

#### Conclusion

Mosaic is the trading backbone of the Movement DeFi stack. Whether you're a trader, builder, or liquidity protocol, Mosaic enables efficient, composable, and trustless trade execution — unlocking the full potential of the Movement ecosystem.

For API keys, SDK usage, and integration support, contact the Mosaic team or visit [the developer portal](/swap-integration/api.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mosaic.ag/products/publish-your-docs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.