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`	The order is marked underfunded.
`executing`	The route is being executed.
`delivered`	The output has reached the destination address.
`expired`	No deposit arrived before the deposit deadline.
`stalled`	Execution needs operator attention.
`frozen`	A policy check halted execution; operator attention is required.

GET/order/{id}OpenAPI ↗

Try it out

Production

Request example

curl --request GET \
  --url 'https://api.rift.trade/order/%7Bid%7D' \
  --header 'Accept: application/json'

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",
  "refund_address": null,
  "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

Amount of to delivered to to_address. Absent until the order is delivered.

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

quote_idstringrequired

The quote this order was created from.

uuid

refund_addressstring | nullrequired

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.

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; expired when nothing arrived by deposit_deadline; stalled when execution gave up and needs an operator; frozen when a step was halted by policy and needs an operator.

Allowed: "awaiting_deposit""funded""underfunded""expired""executing""delivered""stalled""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_fast", "cctp_hyperliquid_fast", "cctp_hyperliquid_standard", "cctp_standard", "chainflip", "flytrade", "hyperliquid_spot", "kyberswap", "lifi_fast", "lifi_standard", "mayan", "morpho", "nordstern", "near_intents", "okx", "relay", "transit", "unit", "velora"

venue_blockliststring[]required

Venues excluded from quoting; empty when none were.

Show child attributes