/moonpay-buy-crypto

name: moonpay-buy-crypto
description: Buy crypto with fiat via MoonPay. Returns a checkout URL to complete the purchase in a browser.
tags: [trading]

Buy crypto with fiat

Goal

Generate a MoonPay checkout URL for buying crypto with a credit card or bank transfer. The user completes the purchase in their browser.

Command

mp buy \
  --token <currency-code> \
  --amount <usd-amount> \
  --wallet <destination-address> \
  --email <buyer-email>

Supported tokens

`btc`, `sol`, `eth`, `trx`, `pol_polygon`, `usdc`, `usdc_sol`, `usdc_base`, `usdc_arbitrum`, `usdc_optimism`, `usdc_polygon`, `usdt_trx`, `eth_polygon`, `eth_optimism`, `eth_base`, `eth_arbitrum`

Example flow

1. User: "I want to buy $50 of SOL with my credit card." 2. Run: `mp buy --token sol --amount 50 --wallet <address> --email user@example.com` 3. Open the returned checkout URL in the user's browser so they can complete the purchase.

Notes

• This is fiat-to-crypto (credit card / bank), not a token swap.
• For token-to-token swaps, use the **moonpay-swap-tokens** skill instead.
• The `--amount` flag is in USD (e.g. `--amount 50` = $50 worth of the token).
• The `--token` flag uses MoonPay currency codes, not mint addresses.
• The checkout URL handles KYC and payment processing.

Related skills

• **moonpay-swap-tokens** — Swap between tokens (no fiat).
• **moonpay-discover-tokens** — Search for tokens.
• **moonpay-auth** — Ensure user is logged in.