Docs/API Endpoints

On this page

Get order status

Retrieve an order using the id returned when it was created. The response includes its status, deposit details, destination address, and amount_out once delivered.

Order statuses

Status	Meaning
`awaiting_deposit`	Waiting for funds at the deposit address.
`funded`	The deposit has been received.
`underfunded`	Far below `from_amount` arrived at the deposit address, and the order can't be filled.
`executing`	The route is being executed.
`delivered`	`amount_out` has reached the destination address.
`refunded`	Execution gave up and `amount_out` was sent back to the refund address.
`expired`	No deposit arrived before the deposit deadline.
`frozen`	Execution was halted by policy, or gave up with no refund destination, or the refund failed. An operator needs to step in.

Repeat this request with the same id to follow an order. Wait a few seconds between checks and back off on transient errors. Stop polling once the order is delivered, refunded, expired, or frozen. If an order is frozen or underfunded, contact the Rift team using Support.

GET/order/{id}OpenAPI ↗

Try it out

Production

Request example

const response = await fetch("https://api.rift.trade/order/%7Bid%7D", {
  method: "GET",
  headers: {
    Accept: "application/json",
  },
});

const data = await response.json();
console.log(data);

Parameters

path parameter

idstringrequired

uuid

Responses

Response status

The order

application/json

Example response

{
  "format": "raw",
  "created_at": "2026-09-23T12:00:00Z",
  "deposit_address": "",
  "deposit_deadline": "2026-09-23T12:00:00Z",
  "from": "",
  "from_amount": "",
  "id": "00000000-0000-4000-8000-000000000001",
  "quote_id": "00000000-0000-4000-8000-000000000001",
  "status": "awaiting_deposit",
  "to": "",
  "to_address": "",
  "vault_id": "00000000-0000-4000-8000-000000000001",
  "venue_allowlist": [],
  "venue_blocklist": []
}

formatstringrequired

The format every amount and asset name in this response is written in, inherited from the quote.

Allowed: "raw""formatted"

amount_outstring | null

What the order settled: the amount of to that reached to_address when the status is delivered, or the amount of from that reached refund_address when it is refunded. Absent until then.

created_atstringrequired

When the order was created.

date-time

deposit_addressstringrequired

Address on the from chain to send from_amount to.

deposit_deadlinestringrequired

Instant after which deposits are no longer watched for and the order expires. Seven days after creation.

date-time

fromstringrequired

Asset to deposit, written per format.

from_amountstringrequired

Amount of from to deposit, exactly as quoted.

idstringrequired

Identifier used in GET /order/{id}.

uuid

integrator_idstring | null

The integrator_id of the quote this order was created from, or null.

Show child attributes

Any of: string 1

string

Any of: null 2

null

quote_idstringrequired

The quote this order was created from.

uuid

refund_addressstring | null

Address on the from chain that receives a refund if the order cannot be completed. Null when none was given; it is then set to the deposit's sender address as soon as the deposit is seen.

Show child attributes

Any of: string 1

string

Any of: null 2

null

statusstringrequired

awaiting_deposit until funds arrive at deposit_address; funded once they are seen; executing while the route runs; delivered when amount_out has reached to_address; refunded when execution gave up and amount_out was sent back to refund_address instead; expired when nothing arrived by deposit_deadline; frozen when the order was halted by policy, when execution gave up with no refund destination, or when the refund itself failed, and needs an operator.

Allowed: "awaiting_deposit""funded""underfunded""expired""executing""delivered""refunded""frozen"

tostringrequired

Asset delivered, written per format.

to_addressstringrequired

Address on the to chain that receives the output.

vault_idstringrequired

Internal identifier of the vault holding the deposit address.

uuid

venue_allowliststring[]required

Venues quoting was restricted to; empty when it was not.

Show child attributes

string · "aave", "across", "cctp", "chainflip", "cowswap", "flytrade", "hyperliquid", "kyberswap", "lifi", "mayan", "morpho", "near_intents", "nordstern", "okx", "relay", "transit", "unit", "velora"

venue_blockliststring[]required

Venues excluded from quoting; empty when none were.

Show child attributes

string · "aave", "across", "cctp", "chainflip", "cowswap", "flytrade", "hyperliquid", "kyberswap", "lifi", "mayan", "morpho", "near_intents", "nordstern", "okx", "relay", "transit", "unit", "velora"

Order statuses

Polling an order

Try it out

Request example

Parameters

Responses