Skip to main content
POST
/
v1
/
orders
curl --request POST \
  --url https://api.aries.com/v1/orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountId": "TEST-ACCOUNT-001",
  "symbol": "AAPL",
  "side": "BUY",
  "type": "MARKET",
  "qty": "10",
  "timeInForce": "DAY"
}
'
{
  "success": true,
  "clOrdId": "ORDER-20260115-001",
  "status": "NEW",
  "symbol": "AAPL",
  "side": "BUY",
  "qty": "100",
  "cumQty": "0",
  "leavesQty": "100",
  "avgPrice": "0",
  "text": "Order accepted",
  "ordRejReason": "",
  "transactTime": "2026-01-15T14:30:05Z"
}

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

Order payload: accountId, symbol, side, type, qty, timeInForce; optional price/legs for limit and options.

Request body for placing a live order through the core trading API. Use Preview Order first when available, then submit this only after the user confirms the trade.

​
accountId
string
required

Trading account identifier that should receive the order. Enter the account ID selected by the user.

Required string length: 1 - 50
Example:

"TEST-ACCOUNT-001"

​
symbol
string
required

Ticker or underlying symbol to trade. Confirm the exact uppercase value with symbol search before placing an order.

Required string length: 1 - 20
Example:

"AAPL"

​
side
enum<string>
required

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"

​
type
enum<string>
required

How the order should execute. MARKET tries to fill immediately at the current market price. LIMIT fills only at your price or better. STOP activates when stopPrice is reached. STOP_LIMIT activates at stopPrice and then uses price as the limit.

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

"LIMIT"

​
qty
string
required

Number of shares or contracts to trade, sent as a decimal string. Example: "10" for ten shares or "1" for one option contract.

Example:

"10"

​
timeInForce
enum<string>
required

How long the order should remain active. DAY cancels at market close if unfilled. GTC stays active until filled or canceled. IOC fills what is available immediately and cancels the rest. FOK fills the entire quantity immediately or cancels the whole order. EXTENDED_HOURS allows eligible extended-hours trading. AT_THE_OPENING and AT_THE_CLOSE target the opening or closing auction.

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

"DAY"

​
clientId
string

Optional identifier from your app. Send this when you want to tag orders by app, user, strategy, or integration for your own reconciliation.

Maximum string length: 50
Example:

"CLIENT-001"

​
price
string

Limit price as a decimal string. Required for LIMIT and STOP_LIMIT orders. For buys, this is the maximum price you will pay; for sells, it is the minimum price you will accept.

Example:

"150.00"

​
stopPrice
string

Trigger price as a decimal string. Required for STOP and STOP_LIMIT orders. When the market reaches this price, the stop order becomes active.

Example:

"145.00"

​
currency
string

Three-letter currency code for the order. Use USD for U.S. dollar orders unless your integration supports another currency.

Required string length: 3
Example:

"USD"

​
legs
object[]

Option legs for single-leg or multi-leg option orders. Omit this field for equity orders. Send 1 leg for a single option contract or 2 to 4 legs for a spread or other multi-leg strategy.

Maximum array length: 4

Response

Order placed successfully

Response returned after submitting an order request. Treat it as acknowledgement and continue monitoring order status until final fill, cancel, or rejection.

​
success
boolean

Whether the order request was accepted by Aries for processing. This does not guarantee a final fill.

Example:

true

​
clOrdId
string

Client order ID assigned to this order. Store this value to look up, replace, or cancel the order later.

Example:

"ORDER-123456"

​
status
string

Current order status. NEW or PENDING means received; FILLED means executed; REJECTED means the brokerage did not accept the order.

Example:

"NEW"

​
symbol
string

Symbol submitted on the order.

Example:

"AAPL"

​
side
string

Direction submitted on the order, such as BUY or SELL.

Example:

"BUY"

​
qty
string

Original order quantity as a decimal string.

Example:

"10"

​
cumQty
string

Quantity already filled. Compare this with qty to understand partial fills.

Example:

"0"

​
leavesQty
string

Quantity still open and eligible to fill. Value becomes 0 when the order is fully filled or no longer active.

Example:

"10"

​
avgPrice
string

Average execution price for filled quantity. This is 0 until fills occur.

Example:

"0"

​
text
string

Broker or system message. Show this to users when it explains a status or warning.

​
ordRejReason
string

Reason the order was rejected, when available. Use this to explain what the user needs to fix.

​
transactTime
string<date-time>

Time Aries or the broker recorded the order transaction.