Skip to main content
GET
Get Exchange Rates
Start a withdrawal session by selecting the asset, fiat currency, amount, and amount side. Keep the returned sessionId and use it for the remaining steps. Include customerId here to withdraw on behalf of a customer. Omit it to withdraw on behalf of the business. The customer is saved in the session; changing customers requires a new rates request. Next, use the session to discover payment methods and get the requirements for the selected method. Reuse the same authentication profile, business, and wallet throughout the session.

Amount limits

When returned, data.limits describes the route before selecting a payment method. It contains only minAmount, maxAmount, currency, and amountSide. Decimal boundaries are inclusive; a null boundary means no configured restriction. For source, compare the total entered crypto budget, including fees. For target, compare the entered fiat payout; required crypto funding includes fees on top. Limits match the request amount side and currency. Do not convert source minimums into fiat minimums. Individual payment methods can have higher minimums than the route. data.amount is the indicative fiat output for a source request, or source conversion principal for a target request. data.debitAmount is estimated source funding. The final quote is authoritative.

Authorizations

x-api-key
string
header
required

Path Parameters

id
string<uuid>
required

Wallet identifier.

Query Parameters

assetId
string<uuid>
required

Stablecoin asset identifier returned by the supported-assets endpoint.

currency
string
required

ISO 4217 fiat currency code.

Required string length: 3
amount
string
required

Decimal amount encoded as a string to preserve precision.

Pattern: ^\d+(\.\d+)?$
amountSide
enum<string>
default:source

Which side of the conversion amount refers to. source (default) fixes the stablecoin amount; target fixes the fiat amount the recipient receives.

Available options:
source,
target
provider
string

Optional provider slug. Omit it to let Blockradar select an eligible provider.

customerId
string<uuid>

ID of an existing active customer owned by the authenticated business.

paymentMethod
string

Optional provider payment-method ID.

Response

Successful response.

message
string
required

Human-readable result.

Example:

"Exchange rate fetched successfully"

data
object
required
status
boolean
required
Example:

true