Docs/API Endpoints

On this page

Poll an order

Track an order by repeating the get order status request with the same id. Each click on Send request below performs one status check.

Polling an order

Wait a few seconds between checks and back off on transient errors. Stop polling when the order is delivered or expired. If it is stalled or frozen, contact the Rift team using Get support.

The API exposes GET /order/{id} for status checks; it does not define a separate POST polling endpoint.

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