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

# POST /replace-order

`POST /replace-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.
    - `p` string, nullable — New price for the replacement order (optional, inherits from original if not provided)
    - `po` boolean, nullable — Whether the replacement order is post-only (optional, inherits from original if not provided)
    - `q` integer, nullable — New quantity for the replacement order (optional, inherits from original if not provided)
    - `tif` string, nullable — New time in force for the replacement order (optional, inherits from original if not provided)
  - 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.
    - `p` string, nullable — New price for the replacement order (optional, inherits from original if not provided)
    - `po` boolean, nullable — Whether the replacement order is post-only (optional, inherits from original if not provided)
    - `q` integer, nullable — New quantity for the replacement order (optional, inherits from original if not provided)
    - `tif` string, nullable — New time in force for the replacement order (optional, inherits from original if not provided)

## Response `200`

Order replaced successfully

- ReplaceOrderResponse
  - `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>

## 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)