Quote

Preview the rate before you send

Ask "what will it cost?" without committing. A quote returns the live exchange rate, fees, and how much the recipient receives — perfect for a confirmation screen. Creating a payment is what actually locks and executes.

⚡

You send

≈ 812.64 KES

↓

🇿🇦

They receive

R 120.00

💡

Today, quotes settle a fixed destination amount — you ask for "10 ZAR settled" and get back the BTC and source-currency amounts required. Specifying a source amount isn't supported yet.

POST /quote

Get a quote

Same idea as a payment, without the side effects. Provide the destination amount plus the source and destination currencies; get back the rate, fees, and the BTC leg.

Body parameters

amount*

number

Amount of destination currency to settle

destinationCurrency*

string

Currency the recipient receives (e.g. ZAR)

sourceCurrency*

string

Currency the payer funds with (e.g. KES, BTC)

POST /quote

{
  "amount": 10,
  "destinationCurrency": "ZAR",
  "sourceCurrency": "KES"
}

Response fields

source

object

Source side: currency, currencyAmount (incl. fee), currencyAmountSansFee, usdRate

destination

object

Destination side: same shape — what the recipient receives

fee

object

feeRate, feeInUsd, otcTxFeeInUsd, totalFeesInUsd

btc

object

btcRate, btcAmount, btcAmountSansFee — the BTC leg of the route

baseCurrency

string

Reference currency for the USD rates (USD)

Indicative vs locked

Quote

Indicative

A quote is a snapshot for display. Rates move — by the time you create the payment, the executed rate may differ slightly.

Payment

Locked at creation

The real rate is fixed when the payment is created (or for the guaranteed window). Use bufferRate to absorb slippage.