Skip to main content
Takes a quoteToken from /quote and returns one execution, tagged by executionType. What to do with each type: Execution types.

Request

string
required
From /quote, or from one of its alternatives.
string
A recipient given late. Only a few venues accept one here; the rest refuse an address that differs from the quote’s (400 INVALID_REQUEST). Set it on the quote instead.
string
A refund address given late. Same rule as destinationAddress.
string
Only when answering a Hinkal AUTHORIZE step, with signature.
string
The paying wallet’s signature over that step’s sign.
string
Any unique value per swap attempt, such as a UUID. A retry with the same key within 24 hours returns the first answer instead of building again, so a timeout never opens a second deposit address. Use a new key for each AUTHORIZE answer.

Response

string
TRANSACTION, SIGNATURE or DEPOSIT (AUTHORIZE for an opted-in Hinkal swap). See Execution types.
string
Use this one, not the quote’s, for every later call.
string
This swap’s id in RAVN’s ledger. Webhooks name it.
string
What to poll /status with, when present.
object
An ERC-20 approval to send and mine first, when needed. May carry reset. See Approvals.
object
TRANSACTION only. EVM: to, data, value, chainId, and gasLimit to send it with. Solana: serialized, base64. Bitcoin: psbt, base64, to sign and post back.
object[]
EVM, when RAVN could build it (almost always). Every transaction to send, in order: approvals, the swap or deposit, then your fee.
boolean
true when calls may go in one atomic wallet batch.
object
Where to post what you signed: /submit-signature on a SIGNATURE, /submit-transaction on a TRANSACTION you must not broadcast.
object
SIGNATURE only. The order to sign. approvalData, when present, is a second one.
object
DEPOSIT only. Send amount of the input token to address. Ready-made: psbt (Bitcoin), transaction (Solana, with your fee). expiresAt, when set, is the deadline: send right away and never after it.
object
Your fee, when this route collects it beside the swap: amount, address, chainId, and on EVM a transaction. See Collecting your fee.
boolean
true on a sandbox quote. Never send it.

Errors