Skip to main content
POST
Display quote for a card purchase
Provider sandbox on this deployment. Our backend targets the card provider’s sandbox: no card is charged and no real transfer settles. Known limits: a purchase never reaches completed (it stops at processing), the settlement asset is the sandbox’s, not production’s (read cryptoCurrency from GET /v1/config), and the EUR window is unpublished (GET /v1/card/limits says window: unpublished). Every response says which environment answered in its environment field.

Authorizations

Authorization
string
header
required

Your API key, issued by us and shown once at creation.

Body

application/json

Anonymous: no email, no identity. The asset and chain are the deployment's fixed corridor, so there is nothing to name here.

fiatCurrency
string
required

ISO 4217 code to charge in. Must be one of the deployment's supported fiat currencies (see GET /v1/card/currencies); others are refused.

Pattern: ^[A-Za-z]{3}$
Example:

"EUR"

fiatAmount
string
required

Fiat to spend, decimal string in major units, greater than zero.

Pattern: ^\d+(\.\d+)?$
Example:

"100"

Response

The display quote.

Display-only quote from the anonymous rate.

environment
enum<string>
required

Which environment answered. sandbox: at least one money upstream is the provider's sandbox - no real money moves there, and the card corridor is the sandbox's asset (read GET /v1/config), not the documented production one. production: every configured upstream is real. Derived from the configured upstream hosts at boot, never a flag.

Available options:
sandbox,
production
Example:

"sandbox"

cryptoAmount
string
required

Crypto the user receives, decimal string in major units.

Example:

"94.812345"

cryptoCurrency
string
required

Which asset cryptoAmount is denominated in - the configured corridor's asset. Always read it next to the number.

Example:

"USDC"

fiatAmount
string
required

Fiat the user spends.

Example:

"100"

rate
string
required

Exchange rate, decimal string.

providerFee
string
required

The provider's fee, in fiat.

ourFee
string
required

Rheon's markup, in fiat ("0" until set).

total
string
required

Total charged in fiat, fees included.

expiresAt
string

ISO 8601 expiry of the displayed rate, when the provider gives one.