ExchangeOrders

Cancel an order

Cancels a `pending` order before the trading desk has begun filling it. Idempotency: **resource-keyed by `orderId`** — no header required. Replay on an already-cancelled order returns `200` with the current state. The `pending → filling` boundary is atomic: exactly one of cancel or begin-filling wins.

Authentication

AuthorizationBearer
Token obtained via the login flow.

Path parameters

orderIdstringRequired

Response

Order cancelled. Reservation in sellCurrency released.

orderIdstring
quoteIdstring
Reference to the originating quote. Quote remains retrievable.
statusenum
  • pending — waiting for trading desk. Cancellable.
  • filling — desk has begun execution. Not cancellable.
  • filled — complete, balances updated.
  • cancelled — client-initiated cancel while pending.
  • failed — could not be filled; funds untouched.
Allowed values:
sellCurrencystring
buyCurrencystring
sellAmountstring
Locked at acceptance.
buyAmountstring
Locked at acceptance.
ratestring
Locked at acceptance.
createdAtdatetime
When the order was created.
updatedAtdatetime
When the order was last updated.

Errors

401
Unauthorized Error
404
Not Found Error
409
Conflict Error