For AI agents: a documentation index is available at /llms.txt. A markdown version of this page is available at the same URL with .md appended (or via Accept: text/markdown).
Skip to main content

Swap and bridge tokens

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

Ask your agent​

You (to your agent): "Swap 0.1 ETH to USDC"

For a cross-chain bridge:

You (to your agent): "Bridge 10 USDC from Base to Arbitrum"

Your agent fetches a quote, shows you the route and output, then executes after you confirm.

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