Replace Order

Modifies an existing open order by replacing it with updated parameters such as price or quantity. This operation cancels the original order and submits a new one atomically, maintaining order continuity.

Use Case: Adjust limit prices or order quantities in response to market movements without losing queue position unnecessarily.

POST /v1/orders/replace

cURL

changeQuantity

curl --request POST \
  --url https://api.aries.com/v1/orders/replace \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "origClOrdId": "ORDER-123456",
  "accountId": "TEST-ACCOUNT-001",
  "symbol": "AAPL",
  "side": "BUY",
  "type": "LIMIT",
  "qty": "20",
  "price": "150.00",
  "timeInForce": "DAY"
}
'

200

{
  "success": true,
  "clOrdId": "ORDER-123457",
  "origClOrdId": "ORDER-123456",
  "status": "REPLACED",
  "qty": "20",
  "price": "150.00",
  "text": "<string>",
  "transactTime": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Body

application/json

Replace payload: origClOrdId, accountId, symbol, side, and updated fields (qty, price, timeInForce, etc.).

origClOrdId · string · required

Original client order ID to replace

Required string length: 1 - 100

Example:

"ORDER-123456"

accountId · string · required

Account identifier

Required string length: 1 - 50

Example:

"TEST-ACCOUNT-001"

symbol · string · required

Trading symbol

Required string length: 1 - 20

Example:

"AAPL"

clientId · string

New client identifier

Maximum string length: 50

side · enum<string>

Order side

Available options: BUY, SELL, SELL_SHORT, BUY_TO_COVER

Example:

"BUY"

type · enum<string>

Order type

Available options: MARKET, LIMIT, STOP, STOP_LIMIT

Example:

"LIMIT"

qty · string

New order quantity

Example:

"20"

price · string

New limit price

Example:

"148.50"

stopPrice · string

New stop price

Example:

"145.00"

timeInForce · enum<string>

Time in force

Available options: DAY, GTC, IOC, FOK, EXTENDED_HOURS, AT_THE_OPENING, AT_THE_CLOSE

Example:

"DAY"

Response

200

application/json

Replace request submitted successfully

success · boolean

Whether the replace was accepted

Example:

true

clOrdId · string

New client order ID

Example:

"ORDER-123457"

origClOrdId · string

Original client order ID

Example:

"ORDER-123456"

status · string

Order status

Example:

"REPLACED"

qty · string

Order quantity

Example:

"20"

price · string

Order price

Example:

"150.00"

text · string

Additional text/message

transactTime · string<date-time>

Transaction timestamp