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

Documentation Index

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

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

​
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. The sample includes every JSON field on the response object. 
{
  "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

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.