Get normalized swap status
Request
- Base URL: https://app.ravn.exchange
- URL: https://app.ravn.exchange/api/v1/status
- Auth: one of:
- API key in header x-api-key
- none
Query parameters
The quoteToken /v1/execute returned — it carries the destinationAddress given at execute.
statusRef from /v1/execute (compose packed handle, or a deposit address) or from /v1/submit-signature; with none, the origin tx hash (the txHash /v1/submit-transaction returned, when execute carried submit). Prefer POST /v1/status — GET with a large compose quoteToken can 431.
Only where a fee the swap carries (fee.bps > 0) was paid in a transaction RAVN can't otherwise find; every other venue proves its fee itself. Two-hop (compose) routes: the hop-1 transaction you broadcast (not needed when hop 1 is gasless, submitted via /v1/submit-signature: its venue's record of the trade proves the fee). A fee RAVN collects beside the swap (the execution's fee.transaction: Rift, private swaps, Eco, Layerswap, Mayan routes paying no referrer) on an EVM chain: the on-chain hash of the transaction that carried that payment (its own, or the batch or relay that included it — not a batch id or a userOpHash) — send it on every status call (RAVN keeps it once that payment has confirmed); not needed when it rode in the swap's own transaction and you poll with that hash. Until RAVN can read that transaction, a delivered swap is answered processing (up to 15 minutes after execute), so keep polling. Without it nothing is owed on that swap: its status is still reported, and RAVN stops waiting for the fee a day after execute.
Response
Status resolved
Changes
No recorded changes to this operation across all 1 revision of this API.