Skip to main content
Elements used:
  • Wallet: Please ensure your Ivy wallet is setup
  • Deposit: Deposit USDC into your Ivy wallet
  • Balance API: Use the /balance/retrieve endpoint to get your available balances
  • FX: Swap your stablecoin balance into fiat
  • Payout: Use the /payout/create endpoint to send funds in EUR

​
How It Works

1

Deposit Crypto Funds to your Wallet

Your Deposit Wallet (chain and address) can be found in the Accounts tab.
Send USDC to this wallet using only your whitelisted wallet (found in Payout destinations)
2

Get a real-time exchange rate

Once funds arrived, use the /fx/retrieve-rate endpoint to fetch the current rate for your desired currency pair.
3

Execute FX

Use the /fx/execute endpoint to swap funds from stablecoins to fiat.
Minimum 10 USDC applies for FX with USDC
4

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.
5

Check Balance

Monitor your conversion in the Dashboard or via webhooks. Funds usually arrive instantly or in a few minutes.Check the balances endpoint for updated balance information.
6

Create a Payout

Choose a Payout type:
  • Closed-loop: Pay a customer who has previously paid in via Ivy (reference their order)
  • Open-loop: Pay any external account using their bank details (IBAN, sort code, etc.)
Use the /payout/create endpoint to specify the amount, currency, and destination (orderId or financial address).