Skip to main content

Swap and bridge tokens

Get a quote, review the route, and execute a same-chain swap or cross-chain bridge.

Prerequisites​

  • Quickstart completed
  • Sufficient balance of the source token on the source chain

Same-chain swap​

  1. Request a quote:

    mm swap quote --from <TOKEN> --to <TOKEN> --amount <AMOUNT> --from-chain <CHAIN_ID> [--slippage <PERCENT>]

  2. Review the quoted output, fees, and route in the command output. Note the quoteId.

  3. Execute the swap:

    mm swap execute --quote-id <QUOTE_ID>

  4. Optionally check status:

    mm swap status --quote-id <QUOTE_ID>

Cross-chain bridge​

Include --to-chain when requesting a quote:

mm swap quote --from USDC --to USDC --amount 10 --from-chain 8453 --to-chain 42161
mm swap execute --quote-id <QUOTE_ID>

Common pitfalls​

Verify the quote step succeeded

If mm swap quote returns an error or no quote ID, do not call mm swap execute with a fabricated or expired quote ID. The execute step fails and no transaction is submitted, even when partial output is printed.

See mm swap in the commands reference.

On this page