Quotation

The Quotation API allows you to retrieve a locked exchange rate and cost estimate before executing a currency conversion or payout.
Each quotation includes the FX rate, fees, and receive amount, and is valid for a limited time. You must obtain a quotation before initiating a transaction.

Flow Overview

1. Request Quotation

   First, choose the quotation type:

   • Conversion (FX only)
   • Payout (cross-border transfer)

   For Conversion quotations:

   • Quotation basis: sourceAmount or destinationAmount
   • Source currency (sourceCurrency)
   • Destination currency (destinationCurrency)
   • Amount to convert

   For Payout quotations:

   • Quotation basis: typically based on destinationAmount
   • Source country
   • Destination country
   • Destination currency (destinationCurrency)
   • Payout method (payoutMethod) — e.g., SWIFT, BANK_TRANSFER
   • Amount (sourceAmount or destinationAmount)

2. Receive Quotation Response

   The response includes:

   • Locked FX rate (fxRate)
   • Estimated fee (fee)
   • Destination amount (destinationAmount)
   • Quotation ID (quotationId)
   • Expiration time (expiresAt) — typically valid for 30–60 seconds

3. Execute Transaction

   Use the quotationId to execute the transaction:

   • /v2/wallets/{wallet_id}/convert: for FX conversion
   • /v2/pay-outs: for payouts

   If the transaction is executed within the validity window, the rate and fee are guaranteed.

Use Cases

• Preview how much the recipient will receive before sending funds
• Lock a rate before internal approval
• Ensure compliance with limits or margin thresholds
• Enable transparent pricing in customer-facing platforms

API Summary

Quotation Validity

• A quotation is typically valid for 5 minutes to 1 hour.
• If the quotation expires, you must request a new one before proceeding.
• The FX rate and fee are fixed only if the transaction is executed within the validity window.
• Expiration time is included in the expiresAt field of the response.