Swap

Get normalized swap status

get/api/v1/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

quoteTokenstring required

The quoteToken /v1/execute returned — it carries the destinationAddress given at execute.

refstring required

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.

txHashstring

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.