Skip to main content
Poll the progress of a swap. ref is the statusRef returned by /execute (DEPOSIT) or /submit-signature (SIGNATURE).

​
Request

​
quoteToken
string
required
The opaque token from /quote.
​
ref
string
required
The statusRef for this swap.
curl -s "https://app.ravn.exchange/api/v1/status?quoteToken=<token>&ref=<statusRef>"

​
Response

​
status
string
Normalized lifecycle state.
​
venue
string
The venue handling the swap.
statusMeaning
pendingAwaiting the deposit / not yet observed
processingFunds received, solver filling
successDelivered
refundedReturned to sender
failedTerminal failure
not_foundref unknown to the venue
unknownVenue not yet wired for tracking
{ "data": { "status": "processing", "venue": "near_intents" } }
Status tracking is live for NEAR Intents today; more venues are being wired. The response shape is stable — venues not yet tracked return status: "unknown".