Skip to main content
An order (ramp) converts between fiat and stablecoins. The ramp type is inferred from the assets: if you send a token it is an off-ramp; if you send fiat it is an on-ramp.

​
Choose a flow

You fix the amount you send. Kravata calculates how much you receive after fees.
  1. Quote with Quote Ramp (Send Based), sending amountSent.
  2. Create the order with Create Ramp (Send Based), sending amountIn.

​
Origin and destination

Both must have status accepted.

​
Locking the quote

Every quote returns a quoteId and a validUntil. Send the quoteId when creating the order to guarantee the quoted rate. A quote can be used once and only until it expires (30 seconds by default).

​
Idempotency

Send an idempotency-key header (a UUID) when creating an order. If a network error forces you to retry, the same key prevents creating the order twice.

​
Report your transfer

After creating the order, send the funds following the deposit instructions in the response (accountDestination for on-ramps, walletDestination for off-ramps). The order expires 10 minutes after creation if no transfer is reported.

​
Order statuses