Skip to main content
Returns a live rate for a card payment. Anonymous: no account, no wallet, no identity - so a buyer can see the price before committing to anything.

​
Request

​
string
required
ISO 4217 code of the currency the buyer pays in (e.g. "EUR").
​
string
required
The amount the buyer pays, as a decimal string (e.g. "100.00"). This is the total charge, fees included - not the amount that gets converted.

​
Response

​
string
What the buyer receives, as a decimal string. Precision follows the asset, so an 18-decimal figure arrives as an 18-decimal string - keep it as a string.
​
string
Which asset cryptoAmount is denominated in. Always read this rather than assuming USDC - the corridor is configurable, and the sandbox settles in ETH.
​
string
The provider’s own fiat figure for the purchase.
​
string
Exchange rate used, in the provider’s convention (fiat per unit of crypto).
​
string
The on-ramp’s fee, in fiat. Already included in total.
​
string
Rheon’s markup, in fiat. "0" until a markup is configured at account level.
​
string
What the buyer is charged in total, in fiat.
​
string
Optional. ISO 8601 expiry of the quoted rate, when the provider supplies one.
Fees are inside the total, not added to it. With a total of 100.00 and a providerFee of 7.00, the buyer pays 100.00 and 93.00 is converted. Displaying the two numbers side by side without saying so reads as a surcharge.
Card fees carry a flat minimum, so the effective rate is much higher on small amounts than on large ones. Quote every amount rather than extrapolating a percentage from one sample.

​
Errors