Skip to main content
GET
/
v1
/
accounts
/
{id}
/
positions
Get Account Positions
curl --request GET \
  --url https://api.aries.com/v1/accounts/{id}/positions \
  --header 'Authorization: Bearer <token>'
{
  "positions": [
    {
      "accountId": "TEST-ACCOUNT-001",
      "symbol": "AAPL",
      "instrument": "EQUITY",
      "quantity": "100",
      "averagePrice": "170.25",
      "realizedPl": "0",
      "unrealizedPl": "515.00",
      "dailyPl": "125.00",
      "valueBought": "17025.00",
      "valueSold": "0",
      "creditUsed": "0",
      "marketValue": "17540.00",
      "createdAt": "2026-01-10T16:00:00Z"
    }
  ],
  "availability": {
    "available": true,
    "source": "cache"
  }
}

​
Demo response (all fields)

This matches trade-xh-svc GetPositionsResponse / PositionResponse (svc/trade-xh-svc/internal/transport/http/response.go). Position numerics are decimal strings. instrument is normalized for display (E, I, O become EQUITY, INDEX, OPTION). The sample includes every JSON field on the response object. 
{
  "positions": [
    {
      "accountId": "TEST-ACCOUNT-001",
      "symbol": "AAPL",
      "instrument": "EQUITY",
      "quantity": "100",
      "averagePrice": "170.25",
      "realizedPl": "0",
      "unrealizedPl": "515.00",
      "dailyPl": "125.00",
      "valueBought": "17025.00",
      "valueSold": "0",
      "creditUsed": "0",
      "marketValue": "17540.00",
      "createdAt": "2026-01-10T16:00:00Z"
    }
  ],
  "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 positions retrieved successfully

Response for GET /v1/accounts/{id}/positions. Cached positions for the account plus data availability metadata (trade-xh-svc). Numeric amounts are returned as decimal strings.

​
positions
object[]

Open positions for the account

​
availability
object

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