Skip to main content

Iron CLI

In addition to the REST API, Iron can be accessed through the MoonPay CLI (mp). The CLI provides direct terminal access to virtual accounts, fiat-to-stablecoin onramps, KYC verification, wallet management, and more. Iron is a MoonPay Company. The mp CLI is the unified command-line tool for all MoonPay products, including Iron.

Installation

This installs the mp binary globally. You can verify the installation with:

Authentication

Before using any commands, you must authenticate with your MoonPay account.
1
Send a verification code to your email.
2
Verify the code you received.
You can check your current session or log out at any time:

Wallet Management

The CLI manages local wallets stored on your machine. Private keys are encrypted with AES-256-GCM using a key stored in your OS keychain. Keys never leave the device.

Creating a Wallet

This creates a new HD wallet with addresses on Solana, Ethereum, and Tron.

Importing a Wallet

You can import an existing wallet from a mnemonic or a private key:

Managing Wallets

Deleting a wallet is irreversible. Make sure you have exported your mnemonic or private key before deleting.

Virtual Accounts

Virtual accounts let you spin up named virtual bank accounts (IBANs, ACH) that automatically convert incoming fiat into stablecoins and deliver them to a registered wallet. This is the primary Iron product accessible via the CLI. For more context on virtual accounts, see Named Virtual Account.

Setting Up a Virtual Account

1
Create an account and start KYC verification.
This returns a URL to complete identity verification.
2
Complete KYC verification. You can check your status or retrieve the verification link at any time.
If verification needs to be restarted:
3
Accept required legal agreements.
4
Register a wallet to receive stablecoin deliveries. This creates a proof-of-ownership message, signs it locally, and submits the registration in a single command.
You can list registered wallets with:

Creating an Onramp

Once your account is verified and a wallet is registered, you can create an onramp rule that converts incoming fiat into stablecoins.
You can retrieve onramp details (including bank information for wire or ACH transfers), list onramps, or cancel them:

Funding via Open Banking

You can trigger a payment directly from the CLI using open banking:
To check the status of a payment:

Viewing Transactions

Checking Balances

After funds have been converted and delivered, you can verify your wallet balances:

Virtual Account Command Reference

Additional MoonPay CLI Capabilities

The mp CLI is the unified interface for the entire MoonPay infrastructure. Beyond Iron’s virtual account and stablecoin features, the same CLI provides access to additional capabilities including buying crypto with fiat, swapping and bridging tokens across chains, transferring assets, setting up trading automations, discovering tokens, and creating multi-chain deposit links. These features support Solana, Ethereum, Base, Polygon, Arbitrum, Optimism, BNB, Avalanche, and TRON. Run mp --help to explore all available commands.