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 Settings > Deposit destinations. Send USDC to this wallet.
2

Get a real-time exchange rate

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