---
title: "POST /cancel-order"
method: POST
path: "/cancel-order"
tags: ["order-gateway"]
---

# POST /cancel-order

`POST /cancel-order`

## Request body

- union
  - object
    - `oid` string, required — Strong type for Order IDs to prevent mixing with other string values Order IDs are ULIDs with a prefix: - Regular orders: O-<ULID> - Liquidation orders: L-<ULID>
    - `aid` string, nullable — Optional account ID, selecting which account's `cid` namespace the reference resolves against. Only meaningful when the order is given by `cid` — a `cid` is unique per account, not globally — and superfluous when `oid` is supplied (server order ids are globally unique). If omitted, the account is inferred from the connection: the user's default account, or the session account for an account-scoped session.
  - object
    - `cid` integer, required
    - `aid` string, nullable — Optional account ID, selecting which account's `cid` namespace the reference resolves against. Only meaningful when the order is given by `cid` — a `cid` is unique per account, not globally — and superfluous when `oid` is supplied (server order ids are globally unique). If omitted, the account is inferred from the connection: the user's default account, or the session account for an account-scoped session.

## Response `200`

Order cancel requested

- CancelOrderResponse
  - `cxl_rx` boolean, required — Whether the cancel request has been accepted; e.g. true, false

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/architect/apis/ax-api-gateway.md) · [All operations](https://skmtc.net/architect/apis/ax-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/architect/ax-api-gateway/revisions/2955c31c524d/schema)