Skip to main content
GET
/
v1
/
accounts
/
{id}
/
orders
Get Account Orders
curl --request GET \
  --url https://api.aries.com/v1/accounts/{id}/orders \
  --header 'Authorization: Bearer <token>'
{
  "orders": [
    {
      "orderId": "ord-7f3a9c2e-0001",
      "clOrdId": "clord-20260115-aapl-001",
      "accountId": "TEST-ACCOUNT-001",
      "clientId": "demo-oauth-client",
      "symbol": "AAPL",
      "side": "BUY",
      "orderType": "LIMIT",
      "status": "WORKING",
      "tif": "DAY",
      "quantity": "100",
      "filledQty": "0",
      "leavesQty": "100",
      "price": "175.50",
      "stopPrice": "",
      "avgPrice": "0",
      "currency": "USD",
      "destination": "NASDAQ",
      "instrument": "EQUITY",
      "category": "EQUITY",
      "text": "Demo order snapshot",
      "legs": [
        {
          "symbol": "AAPL",
          "side": "BUY",
          "ratioQty": "1",
          "positionEffect": "OPEN",
          "securityType": "CS",
          "maturity": "",
          "strikePrice": "",
          "putCall": ""
        }
      ],
      "createdAt": "2026-01-15T14:30:00Z",
      "updatedAt": "2026-01-15T14:30:05Z"
    }
  ],
  "availability": {
    "available": true,
    "source": "cache"
  }
}

Documentation Index

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

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

For new integrations, use List active orders (v2) and List order history (v2). They return the v2 domain order shape (aligned with WebSocket updates); this page documents the legacy v1 snapshot with availability and different per-order field names.

​
Demo response (all fields)

This matches trade-xh-svc GetOrdersResponse / OrderResponse JSON (svc/trade-xh-svc/internal/transport/http/response.go). The API reference uses the same sample values below for each field (not generic type placeholders). Production responses may omit optional fields when empty (legs, text, timestamps, etc.). instrument, category, and destination are whatever strings the upstream order snapshot provides—not always full names like EQUITY. 
{
  "orders": [
    {
      "orderId": "ord-7f3a9c2e-0001",
      "clOrdId": "clord-20260115-aapl-001",
      "accountId": "TEST-ACCOUNT-001",
      "clientId": "demo-oauth-client",
      "symbol": "AAPL",
      "side": "BUY",
      "orderType": "LIMIT",
      "status": "WORKING",
      "tif": "DAY",
      "quantity": "100",
      "filledQty": "0",
      "leavesQty": "100",
      "price": "175.50",
      "stopPrice": "",
      "avgPrice": "0",
      "currency": "USD",
      "destination": "NASDAQ",
      "instrument": "EQUITY",
      "category": "EQUITY",
      "text": "Demo order snapshot",
      "legs": [
        {
          "symbol": "AAPL",
          "side": "BUY",
          "ratioQty": "1",
          "positionEffect": "OPEN",
          "securityType": "CS",
          "maturity": "",
          "strikePrice": "",
          "putCall": ""
        }
      ],
      "createdAt": "2026-01-15T14:30:00Z",
      "updatedAt": "2026-01-15T14:30:05Z"
    }
  ],
  "availability": {
    "available": true,
    "source": "cache"
  }
}

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 whose recent orders you want to read. Enter the account ID selected by the user.

Response

Account orders retrieved successfully

Response for GET /v1/accounts/{id}/orders. Contains recent cached orders for the account plus data availability metadata (trade-xh-svc).

​
orders
object[]

Recent orders for the account

​
availability
object

Metadata for cached account data: whether values are available and their source.