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 ' { "account": "TEST-ACCOUNT-001", "symbol": "AAPL", "tradeAction": "buy", "orderType": "MARKET", "quantity": 10, "route": "smart", "timeInForce": "DAY" } '
{
  "cost": "1500.00",
  "commission": "0.00",
  "fees": "0.01",
  "buyingPowerImpact": "1500.01",
  "marginRequirement": "0.00",
  "numDayTrades": 0
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Request schema for order preview (tradesvc)

​
account
string

Account identifier

Example:

"TEST-ACCOUNT-001"

​
symbol
string

Trading symbol (for options, use full OCC symbol)

Example:

"AAPL"

​
tradeAction
enum<string>

Trade action

Available options:
buy,
sell
Example:

"buy"

​
orderType
enum<string>

Order type

Available options:
MARKET,
LIMIT,
STOPMARKET,
STOPLIMIT
Example:

"LIMIT"

​
quantity
integer<int64>

Order quantity

Example:

10

​
limitPrice
string

Limit price (float64 as string)

Example:

"150.00"

​
stopPrice
string

Stop price (float64 as string)

Example:

"145.00"

​
route
string

Order routing

Example:

"smart"

​
timeInForce
enum<string>

Time in force

Available options:
DAY,
GTC,
OPG,
IOC,
FOK,
GTD,
EXT
Example:

"DAY"

​
legs
object[]

Option legs (required for option/multi-leg orders)

Response

Order preview calculated successfully

Response schema for order preview

​
cost
string

Total cost of the order (decimal string)

Example:

"1500.00"

​
commission
string

Commission fees (decimal string)

Example:

"0.00"

​
fees
string

Regulatory and exchange fees (decimal string)

Example:

"0.01"

​
buyingPowerImpact
string

Impact on buying power (decimal string)

Example:

"1500.01"

​
marginRequirement
string

Margin requirement for the order (decimal string)

Example:

"0.00"

​
optionFees
string

Option-specific fees (decimal string)

Example:

"0.70"

​
optionPremium
string

Option premium cost (decimal string)

Example:

"550.00"

​
optionRequirement
string

Option-specific requirement (decimal string)

Example:

"0.00"

​
numDayTrades
integer<int64>

Number of day trades this order would trigger

Example:

0

​
rejectReason
string

Reason if order would be rejected

​
warnDescription
string

Warning description if applicable

​
warnRuleId
integer<int64>

Warning rule ID if applicable