Skip to main content
POST
/
v1
/
orders
/
preview
curl --request POST \
  --url https://api.aries.com/v1/orders/preview \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountId": "TEST-ACCOUNT-001",
  "symbol": "AAPL",
  "side": "BUY",
  "type": "MARKET",
  "qty": "10",
  "timeInForce": "DAY"
}
'
{
  "estimatedCost": "1500.00",
  "estimatedMargin": "0.00",
  "commission": "0.00",
  "fees": "0.01",
  "buyingPowerImpact": "1500.01",
  "numDayTrades": 0
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
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>
required

Order side

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

"BUY"

​
type
enum<string>
required

Order type

Available options:
MARKET,
LIMIT,
STOP,
STOP_LIMIT
Example:

"LIMIT"

​
qty
string
required

Order quantity (decimal string)

Example:

"10"

​
timeInForce
enum<string>
required

Time in force

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

"DAY"

​
clientId
string

Optional client identifier

Maximum string length: 50
Example:

"CLIENT-001"

​
price
string

Limit price (required for LIMIT and STOP_LIMIT orders)

Example:

"150.00"

​
stopPrice
string

Stop price (required for STOP and STOP_LIMIT orders)

Example:

"145.00"

​
currency
string

Currency code (3 characters)

Required string length: 3
Example:

"USD"

​
legs
object[]

Option legs array. Order type is derived from this:

  • Empty/omitted = Equity order
  • 1 leg = Single-leg option
  • 2-4 legs = Multi-leg option
Maximum array length: 4

Response

Order preview calculated successfully

Response schema for order preview (PreviewOrdResponse)

​
estimatedCost
string

Estimated total cost of the order

Example:

"1500.00"

​
estimatedMargin
string

Estimated margin for the order

Example:

"0.00"

​
commission
string

Commission fees

Example:

"0.00"

​
buyingPowerImpact
string

Impact on buying power

Example:

"1500.01"

​
fees
string

Regulatory and exchange fees

Example:

"0.01"

​
optionFees
string

Option-specific fees

Example:

"0.70"

​
optionRequirement
string

Option requirement for the order

Example:

"0.00"

​
optionPremium
string

Option premium cost

Example:

"550.00"

​
numDayTrades
integer

Number of day trades this order would trigger

Example:

0

​
warnRuleId
string

Warning rule ID if applicable

​
warnings
string[]

Warning messages if applicable

​
errors
string[]

Error messages if order would be rejected