Skip to main content
There are 2 ways to onramp funds via Ivy:
  1. Using Settlements, you can sweep your fiat balance to USDC using a saved wallet address to send one-off or recurring settlements to. The swap and payout steps happen in one operation.
  2. (Coming Soon) Use FX + Payouts to swap your fiat balance into USDC and payout USDC separately. Using this method you can swap custom amounts and payout on demand.

Supported Currencies & Chains

  • Fiat: EUR, GBP, USD (soon)
  • Stablecoins: USDC (Ethereum, Solana, Polygon)

How It Works

  • FX + Payouts (coming soon)
  • Settlements
With a positive balance account (check using /balance/retrieve) you can start the onramp flow:
1

Get a real-time exchange rate

Use the /fx/retrieve-rate endpoint to fetch the current rate for your desired currency pair.
2

Execute FX

Use the /fx/execute endpoint to swap funds from fiat to stablecoins.
3

Fetch FX details

After creating an FX swap, you’ll receive an fxId on the FX object. Use this fxId with the /fx/retrieve endpoint to fetch details about the exchange rate and conversion used for that specific swap.
4

Create a Payout

Use the /payout/create endpoint to specify the amount, currency, and destination wallet.
5

Track Status

Monitor payout status in the Dashboard or via webhooks. Funds usually arrive instantly, but can take up to 2 business days depending on the bank.