Cancel Order

Cancels an existing open or partially filled order identified by order ID. This action immediately requests order cancellation from the exchange, preventing further execution while preserving any partial fills already completed.

Use Case: Stop unfilled orders when market conditions change or trading strategies need adjustment before complete execution.

POST /v1/orders/cancel

cURL

cancelEquity

curl --request POST \
  --url https://api.aries.com/v1/orders/cancel \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "origClOrdId": "ORDER-123456",
  "accountId": "TEST-ACCOUNT-001",
  "symbol": "AAPL",
  "side": "BUY",
  "securityType": "CS"
}
'

200

{
  "success": true,
  "clOrdId": "ORDER-123456",
  "origClOrdId": "ORDER-123456",
  "status": "CANCELED",
  "text": "<string>"
}

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

Cancel payload: origClOrdId, accountId, symbol, side, securityType; putCall/strikePrice/maturity for options.

origClOrdId · string · required

Original client order ID to cancel

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"

side · enum<string>

Order side

Available options: BUY, SELL, SELL_SHORT, BUY_TO_COVER

Example:

"BUY"

securityType · enum<string>

Security type

Available options: CS, OPT

Example:

"CS"

putCall · enum<string>

Put or Call (for options)

Available options: PUT, CALL, P, C

Example:

"CALL"

strikePrice · string

Strike price (for options)

Example:

"150.00"

maturity · string

Maturity date in YYYY-MM-DD format (for options)

Pattern: ^\d{4}-\d{2}-\d{2}$

Example:

"2025-01-17"

Response

200

application/json

Cancel request submitted successfully

success · boolean

Whether the cancel was accepted

Example:

true

clOrdId · string

Client order ID

Example:

"ORDER-123456"

origClOrdId · string

Original client order ID

Example:

"ORDER-123456"

status · string

Order status

Example:

"CANCELED"

text · string

Additional text/message