Account Positions

Retrieve all open positions for a specific trading account including quantity, cost basis, current market value, and unrealized profit/loss. Track portfolio holdings and performance metrics in real-time.

Use Case: Display a portfolio summary with current positions, P&L, and percentage gains/losses for each holding.

GET /v1/accounts/{id}/positions

Get Account Positions

cURL

curl --request GET \
  --url https://api.aries.com/v1/accounts/{id}/positions \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "positions": [
    {
      "accountId": "TEST-ACCOUNT-001",
      "symbol": "AAPL",
      "securityType": "CS",
      "quantity": "100",
      "averagePrice": "170.25",
      "todayRealizedPnL": "0",
      "unrealizedPl": "515.00",
      "dailyPl": "125.00",
      "createdAt": "2026-01-10T16:00:00Z"
    }
  ],
  "availability": {
    "available": true,
    "source": "cache"
  }
}

Demo response (all fields)

Position quantities and prices are returned as decimal strings to preserve precision. The sample below includes every JSON field the response object can contain.

{
  "positions": [
    {
      "accountId": "TEST-ACCOUNT-001",
      "symbol": "AAPL",
      "securityType": "EQUITY",
      "quantity": "100",
      "averagePrice": "170.25",
      "todayRealizedPnL": "0",
      "unrealizedPl": "515.00",
      "dailyPl": "125.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 whose positions you want to read. Enter the account ID from User Accounts.

Response

200

application/json

Account positions retrieved successfully

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

positions · object[]

Open positions for the account

Show child attributes

availability · object

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

Show child attributes