Skip to main content
GET
/
v2
/
accounts
/
{id}
/
orders
List active orders (v2)
curl --request GET \
  --url https://api.aries.com/v2/accounts/{id}/orders \
  --header 'Authorization: Bearer <token>'
{
  "orders": [
    {
      "clOrdId": "clord-20260115-aapl-001",
      "ordId": "ord-7f3a9c2e-0001",
      "accountId": "TEST-ACCOUNT-001",
      "clientId": "demo-oauth-client",
      "symbol": "AAPL",
      "side": "BUY",
      "type": "LIMIT",
      "timeInForce": "DAY",
      "qty": "100",
      "price": "175.50",
      "stopPrice": "",
      "ordStatus": "NEW",
      "cumQty": "0",
      "leavesQty": "100",
      "avgPrice": "0",
      "currency": "USD",
      "exDestination": "NASDAQ",
      "text": "",
      "ordRejReason": "",
      "securityType": "EQUITY",
      "category": "SINGLE_LEG",
      "legs": [],
      "createdAt": "2026-01-15T14:30:00Z",
      "updatedAt": "2026-01-15T14:30:05Z"
    }
  ],
  "nextCursor": 0
}

Documentation Index

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

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

​
Compared to v1 account orders

Account Orders (GET /v1/accounts/{id}/orders) returns legacy field names (orderType, status, quantity, …) and an availability object. This v2 endpoint returns domains/order.Order objects (field names type, ordStatus, qty, …) and paginates with nextCursor instead of bundling availability metadata.

​
Demo response (v2 shape)

Numeric quantities and prices are decimal strings. This matches trade-xh-svc v2 marshaling (cache and DB). Optional string fields may be omitted when empty in production. 
{
  "orders": [
    {
      "clOrdId": "clord-20260115-aapl-001",
      "ordId": "ord-7f3a9c2e-0001",
      "accountId": "TEST-ACCOUNT-001",
      "clientId": "demo-oauth-client",
      "symbol": "AAPL",
      "side": "BUY",
      "type": "LIMIT",
      "timeInForce": "DAY",
      "qty": "100",
      "price": "175.50",
      "stopPrice": "",
      "ordStatus": "NEW",
      "cumQty": "0",
      "leavesQty": "100",
      "avgPrice": "0",
      "currency": "USD",
      "exDestination": "NASDAQ",
      "text": "",
      "ordRejReason": "",
      "securityType": "EQUITY",
      "category": "SINGLE_LEG",
      "legs": [],
      "createdAt": "2026-01-15T14:30:00Z",
      "updatedAt": "2026-01-15T14:30:05Z"
    }
  ],
  "nextCursor": 0
}

Authorizations

​
Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Path Parameters

​
id
string
required

Account ID (for example SIM7010UJIY6)

Query Parameters

​
source
enum<string>

Read source. Defaults to server configuration ORDERS_V2_DEFAULT_SOURCE (typically cache). Unknown values yield 400.

Available options:
cache,
db
​
limit
integer
default:50

Page size. Default 50; server maximum 500.

Required range: 1 <= x <= 500
​
cursor
integer<int64>
default:0

Opaque pagination cursor. Use 0 for the first page; otherwise pass the previous nextCursor.

Response

Page of active orders

Paginated v2 orders response from GET /v2/accounts/{id}/orders and GET /v2/accounts/{id}/orders/history (trade-xh-svc).

​
orders
object[]
required

Orders in v2 domain shape

​
nextCursor
integer<int64>
required

Pass as cursor on the next request. Value 0 means this page is the last.