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

​
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 ID

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.