Preview Order

Simulates an order submission to calculate estimated costs, fees, commissions, and buying power impact before actual execution. Returns detailed breakdown of order economics without committing to the trade.

Use Case: Review total order costs and verify buying power sufficiency before placing trades to avoid rejections and unexpected fees.

POST /v1/orders/preview

cURL

equityMarket

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" } '

200

equityPreview

{ "estimatedCost": "1500.00", "estimatedMargin": "0.00", "commission": "0.00", "fees": "0.01", "buyingPowerImpact": "1500.01", "numDayTrades": 0 }

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

Same structure as Place Order (PlaceOrdRequest); returns estimated cost and buying power impact without placing.

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

Show child attributes

Response

200

application/json

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