Skip to main content
GET
The live buy rate for an amount
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.

Query Parameters

side
string

Only "buy" is priced. Omitted means buy.

Allowed value: "buy"
Example:

"buy"

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"

cryptoCurrency
string
required

Must equal the deployment's configured settlement asset (case-insensitive). Anything else is refused with a message naming what is configured and which environment this is. Read GET /v1/config or GET /v1/card/currencies to learn it - on the sandbox it is the provider's sandbox asset (ETH), not USDC.

Example:

"USDC"

amount
string
required

Fiat amount to price, decimal string in major units, greater than zero. This parameter is named amount (not fiatAmount); a missing or malformed value is refused with 400 invalid_request naming it, before the provider is asked.

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

"100"

Response

The rate, fees included.

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"

side
string
required
Allowed value: "buy"
fiatCurrency
string
required
Example:

"EUR"

cryptoCurrency
string
required
Example:

"USDC"

fiatAmount
string
required

Fees included - what the buyer would actually be charged.

cryptoAmount
string
required
rate
string
required