Skip to main content
Poll every swap until it’s final. Besides your UI, it’s how RAVN confirms the swap, and only confirmed swaps earn your fee. GET with query parameters also works, but POST is safer: a quoteToken can be too long for a URL.

Request

string
required
The one /execute returned, not the one from /quote.
string
required
The statusRef from /execute (or from /submit-signature on a SIGNATURE). On a TRANSACTION without one, the swap’s transaction hash.
string
EVM only: the hash of the last transaction you sent from calls, which proves your fee. Send it on every poll. See Collecting your fee.

Response

string
One of the values below.
string
The venue handling the swap.
string
The venue’s own raw status, for debugging.
string
Once final, what was delivered, when the venue reports it.
string
Once final, the transaction that paid the user, when the venue names one.
string
"unavailable" when status is unknown.
Poll every 5 to 10 seconds, or 10 to 15 for a Bitcoin deposit. A failed call (a 429, a network blip) changes nothing: retry it. The swap is credited to the key that made the quote, even when later calls don’t send that key.