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

[
  {
    "averagePrice": "<string>",
    "buyingPowerUsed": "<string>",
    "pnlToday": "<string>",
    "quantity": "<string>",
    "symbol": "<string>"
  }
]

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

200

application/json

Account positions retrieved successfully

averagePrice · string

Average cost basis price

buyingPowerUsed · string

Buying power used for position

pnlToday · string

Profit/loss for today

quantity · string

Position quantity

symbol · string

Trading symbol