Skip to main content
POST
/
v1
/
orders
/
cancel
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"
}
'
{
  "success": true,
  "clOrdId": "ORDER-20260115-002",
  "origClOrdId": "ORDER-20260115-001",
  "status": "CANCELED",
  "text": "Cancel request processed"
}

Documentation Index

Fetch the complete documentation index at: https://finance.dev/llms.txt

Use this file to discover all available pages before exploring further.

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.

Request body for canceling an open order through the core trading API. Use this when the user wants to stop an order that has not fully filled.

​
origClOrdId
string
required

Client order ID of the original order you want to cancel. Use the clOrdId returned by Place Order or List active orders.

Required string length: 1 - 100
Example:

"ORDER-123456"

​
accountId
string
required

Trading account identifier that owns the order being canceled. It must match the account on the original order.

Required string length: 1 - 50
Example:

"TEST-ACCOUNT-001"

​
symbol
string
required

Symbol on the original order. Use the exact symbol from the order record.

Required string length: 1 - 20
Example:

"AAPL"

​
side
enum<string>

Direction of the trade. Use BUY when purchasing shares or contracts, SELL when selling a position you own, SELL_SHORT when opening a short sale, and BUY_TO_COVER when closing a short position.

Available options:
BUY,
SELL,
SELL_SHORT,
BUY_TO_COVER
Example:

"BUY"

​
securityType
enum<string>

Type of instrument on the order. Use CS for common stock/equity orders and OPT for option orders.

Available options:
CS,
OPT
Example:

"CS"

​
putCall
enum<string>

Option contract type for option cancels. Use CALL/C for calls and PUT/P for puts. Omit for equity cancels.

Available options:
PUT,
CALL,
P,
C
Example:

"CALL"

​
strikePrice
string

Option strike price as a decimal string. Send this for option cancels when the original order was an option order.

Example:

"150.00"

​
maturity
string

Option expiration date in YYYY-MM-DD format. Send this for option cancels when the original order was an option order.

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

"2025-01-17"

Response

Cancel request submitted successfully

Response returned after requesting an order cancel. Treat it as the cancel result and continue monitoring if the status is pending.

​
success
boolean

Whether Aries or the broker accepted the cancel request for processing.

Example:

true

​
clOrdId
string

Client order ID associated with the cancel action. Store it for audit and status matching.

Example:

"ORDER-123456"

​
origClOrdId
string

Client order ID of the original order being canceled. Use it to connect this cancel result to the user's order.

Example:

"ORDER-123456"

​
status
string

Order status after the cancel request. CANCELED means no further fills should occur; pending statuses require continued monitoring.

Example:

"CANCELED"

​
text
string

Broker or platform message about the cancel result. Show it when the cancel is rejected or needs explanation.