Exchange at market rate

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.

foreign_id

string

required

Unique ID of this exchange in your system, up to 255 characters. It must be unique among your withdrawals and exchanges, and it's case-insensitive.

Maximum string length: 255

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

Created

data

object

Hide child attributes

data.sender_currency

string

required

The currency being exchanged from.

data.sender_amount

string

required

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

required

The currency being exchanged to.

data.receiver_amount

string

required

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

required

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

data.fee_amount

string

required

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

required

The exchange rate used: units of receiver_currency for 1 unit of sender_currency.

Example:

"0.99978134"

data.id

integer

required

Transaction ID.

data.foreign_id

string

required

This exchange's unique identifier in your system.

data.type

string

required

Transaction type: exchange.

data.status

string

required

Exchange status. An exchange callback is sent when the status changes to confirmed.

Reference

Deposits

Withdrawals

Payment requests

Exchanges

Currencies

Transactions

Account balance

System Health

Authorizations

Headers

Body

Response