Skip to main content

Orders — User Flow

Status: liveAudience: PublicLast updated: Nov 01, 2025

TL;DR
Place limit-style buy/sell orders with funds held safely in escrow until they fill or expire. You can cancel while open to unlock funds. Fills execute at or better than your limit, by you or automated participants.

Orders — User Flow

Place limit buys and sells with funds held safely in escrow. Track status in real time and manage orders from one place.

Secure escrow Price control Real-time updates

Limit-style orders

Buy locks stablecoin; Sell locks the asset. Funds stay reserved until the order ends.

Clear outcomes

Orders end as Filled, Expired, or Canceled. Partial fills may occur when enabled.

Executable quotes

Fills happen at or better than your limit, by you or automated liquidity participants.

Easy cancel

Cancel while open to unlock funds instantly. Amend by cancel + recreate.

0) Context

  • Users place limit-style escrow orders:
    • Buy locks stablecoin.
    • Sell locks the asset.
  • Funds stay in escrow until the order reaches a terminal state: Filled, Expired, or Canceled.
  • A fill can be submitted by the user or by automated liquidity participants when the price meets the limit.

1) User flow (step-by-step)

  1. Create — Choose Buy/Sell, set size, limit price, expiry; sign to lock funds in escrow.
  2. Open — Order is live and waiting for executable conditions.
  3. Fill — When market reaches your limit or better, anyone permitted may submit the fill; settlement lands in your wallet.
  4. Expire — If expiry is reached first, funds unlock back to you.
  5. Cancel — You can cancel while open to unlock funds; amend terms by cancel + recreate.

1a) Partial fills & remainder handling

  • Partial fills — Your order can fill in chunks as liquidity appears at or better than your limit.
  • Remainder options — UIs may offer:
    • Keep remainder in escrow (default): stay open for more fills until expiry.
    • Auto-return remainder: after each partial fill, unlock any leftover immediately.
  • Constraints (if supported) — Optional min-fill % or good-'til-time can be used to control fill quality and timing.

Tip: If you need to change size, limit price, or expiry, use cancel + recreate (below) for a clean, auditable reset.

Cancel to unlock funds Recreate with new terms Fresh signature & receipt Preserves clear audit trail

Why we do this: changing price/size mid-flight can be ambiguous. Cancel + recreate guarantees clarity on what you agreed to and when.

OpenPartialFilledExpiredCanceled

2) High-level paths

See also