🌍 Recipe: Global Clearing & FX Liquidity

For established financial institutions, gaining access to deep liquidity and wholesale FX rates is paramount. This guide outlines how to leverage the Verto Engine to programmatically convert high volumes of capital across 50+ currencies.

🧭 Implementation Context

1️⃣ Step 1: Check Current Liquidity

Before executing a bulk trade, verify your master wallet holds sufficient capital. Verto supports both pre-funded (Wallet) and post-funded (Settlement) credit lines.

curl --request GET \
  --url 'https://api.sandbox.vertofx.com/wallets?currency=GBP' \
  --header 'Authorization: Bearer YOUR_API_KEY'

💡

Treasury Tip: Maintain at least a 10% liquidity buffer in your primary G10 currencies to avoid latency during peak trading hours.

2️⃣ Step 2: Request Wholesale Quote

Fetch a firm quote. For Fintech partners, Verto provides raw interbank pricing based on your predefined volume tier.

const quote = await fetch('https://api.sandbox.vertofx.com/rates?currencyFrom=GBP&currencyTo=AED', {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
console.log(await quote.json()); 

3️⃣ Step 3: Execute Block Trade

Unlike standard consumer logic, Fintechs often trade in bulk (e.g., converting 1,000,000 GBP to AED in a single instruction to fulfill 5,000 individual user remittance requests locally).

curl --request POST \
  --url https://api.sandbox.vertofx.com/trades \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "currencyFrom": "GBP",
    "currencyTo": "AED",
    "amountFrom": 1000000,
    "purpose": "Treasury Sweeping"
  }'

4️⃣ Step 4: Reconcile Balances

Verto settles FX trades asynchronously to optimize routing. Listen to the exchange_completed webhook.

{
  "event": "exchange_completed",
  "tradeId": "trd_55x-99z",
  "status": "SETTLED",
  "creditedAmount": "4605000.00",
  "currency": "AED"
}

Once received, your local AED wallet is instantly credited, allowing you to instantly push out payouts on local domestic UAE rails!