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

​
Request

​
string
required
The opaque token from /quote.
​
string
required
The statusRef for this swap.
No API key required (see Authentication for the optional higher-limit tiers).

​
Response

​
string
The normalized lifecycle state.
​
string
The venue handling the swap.
​
string
The raw, venue-native status string behind the normalized status, for debugging. Present once a venue has been polled.
​
string
Present as "unavailable" only when the venue is not yet wired for tracking (status is unknown). Absent otherwise.
Status tracking is live today for CoW, NEAR Intents, Relay, Across, Mayan, Eco Routes, Garden, Chainflip, and THORChain. Jupiter, Bebop, and 0x Gasless aren’t wired yet and return a status of unknown with tracking: "unavailable". The response shape is stable regardless, so each venue is a drop-in as it’s added.
Keep polling on expired. It is not a terminal state. It means the deal lapsed and a refund is owed but has not landed yet. On Across, the deposit is returned to the sender on the origin chain roughly 90 minutes later, at which point the status becomes refunded. Treat only success, refunded, and failed as terminal; stopping at expired will miss the refund.