These docs are for v3. Click to read the latest docs for v4.

Order Quotation

Order Quotations are used to quote a wallet order if you use our API instead of the Hosted Widget.

To quote a different sourceCurrency please set it to a supported presentment currency such as USD, GBP, EUR etc.

There are two ways to specify the "amount" field.

  • amount (will always be the fiat amount without fees included)
  • sourceAmount/destAmount (fiat amount, crypto amount respectively, use only one, not both)

When sourceAmount/destAmount is specified, amountIncludeFees is mandatory. This informs whether the amount has fees already included or not. This approach does not lock the rates. It can slightly change form the moment of the quote and the moment the order is placed. If you want rates locking, please use Wallet Order Reservations instead.

How amountIncludeFees Works:

amountIncludeFees = false
Fees are added on top: $100 + fees will be charged to the user. The user receives the full $100 in value.

amountIncludeFees = true
Fees will be subtracted from the amount: $100 - fees will be sent to the user's wallet. The user receives the amount less the fees.

🚧

User Spending Limits

User spending limits are always calculated in USD using the current market rates between sourceCurrency and USD. Read about limits here.

📘

Rates Locking

Locked rates will expire in 15 minutes.