Get a fixed exchange quote

Authorizations

X-Processing-Key

string

header

required

Your API key.

Headers

X-Processing-Signature

string

required

Hex-encoded HMAC-SHA512 signature of the request body, generated using your secret key.

Body

application/json

sender_currency

string

required

Currency to exchange from. For a list of all available currencies, see API currency codes.

receiver_currency

string

required

Currency to exchange to. For a list of all available currencies, see API currency codes.

sender_amount

The amount you want to exchange, in sender_currency, as a decimal string (for example, "100") or a number. Include either this parameter or receiver_amount, not both.

Up to 8 decimal places, or fewer for some currency pairs. The minimum is the min_amount of sender_currency in /v2/currencies/rates.

receiver_amount

The amount you want to receive, in receiver_currency, before the exchange fee, as a decimal string (for example, "100") or a number. Include either this parameter or sender_amount, not both.

Up to 8 decimal places, or fewer for some currency pairs. The minimum is the min_amount of receiver_currency in /v2/currencies/rates, for the pair in the opposite direction.

Response

data

object

Hide child attributes

data.sender_currency

string

The currency being exchanged from.

data.sender_amount

string

The amount exchanged from sender_currency: the sender_amount from the request, or the amount calculated for the receiver_amount you sent. It doesn't include the exchange fee (see fee_amount).

data.receiver_currency

string

The currency being exchanged to.

data.receiver_amount

string

The amount the exchange gives in receiver_currency: the receiver_amount from the request, or the amount calculated for the sender_amount you sent. It's the amount before the exchange fee: if the fee is charged in receiver_currency, the amount added to your balance is receiver_amount − fee_amount.

data.fee_currency

string

The currency the exchange fee is charged in: sender_currency or receiver_currency.

data.fee_amount

string

The exchange fee. If it's charged in sender_currency, the amount taken from your balance is sender_amount + fee_amount; if it's charged in receiver_currency, the amount added to your balance is receiver_amount − fee_amount. 0.00000000 when no fee is charged, for example for an exchange between the same currency on different networks.

data.price

string

The quoted exchange rate: units of receiver_currency for 1 unit of sender_currency, with 8 decimal places, so sender_amount × price can differ slightly from receiver_amount. Pass it to /v2/exchange/fixed exactly as returned.

Example:

"0.99978134"

data.ts_fixed

integer

Unix timestamp, in seconds, when the quote rate was fixed.

data.ts_release

integer

Unix timestamp, in seconds, when the quote expires.

data.fix_period

integer

How long the fixed quote remains valid, in seconds. After this period, request a new quote.

Reference

Deposits

Withdrawals

Payment requests

Exchanges

Currencies

Transactions

Account balance

System Health

Authorizations

Headers

Body

Response