Skip to main content
POST
Create on-demand conversion

Authorizations

API-Key
string
header
required

Your public API key. Identifies the partner making the request.

API-Sign
string
header
required

HMAC signature over the request, computed with your private key.

API-Nonce
string
header
required

Monotonically increasing nonce included in the request signature.

Headers

Idempotency-Key
string<uuid>
required

UUID that identifies this create request. It must be unique. Reusing it returns a conflict error and does not create a new conversion.

Path Parameters

account_id
string
required

Identifier of the selected account that owns the conversion.

Required string length: 14 - 42
Example:

"WVSD33HRMGSZUBM7"

Body

application/json

Provide from.amount to specify how much to debit. Omit to.amount; the service calculates the amount delivered to the destination.

from
OnDemandConversionBalanceSource · object
required

Source side of an on-demand conversion.

to
OnDemandConversionWalletDestination · object
required

Destination side of an on-demand conversion.

Response

On-demand conversion created.

data
object
required

Details of an on-demand conversion. It includes the amount debited from the account, the amount delivered to the wallet, the exchange rate, destination details, and timestamps. Fees and transaction references are included when available. A saved destination memo or tag is returned in every response.