Skip to main content
POST

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

Client-generated canonical UUIDv4 that uniquely identifies a request for safe retries.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
Example:

"550e8400-e29b-41d4-a716-446655440000"

Path Parameters

account_id
string
required

Globally unique public identifier for an account.

Required string length: 14 - 42

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 source, the amount delivered to the destination, the exchange rate, destination details, and fees. Transaction references are included when available. A linked bank source remains pending while funding is in progress. An RfP conversion includes next_action while its payer must authorize the payment. A wallet destination may include a saved memo or tag; when present, those fields are returned in every response.