Accounts

Get account holdings

Retrieve all current positions held in the specified account. Supports filtering by position type to distinguish between direct trades and Symphony-managed positions.

get/api/v0.1/accounts/{account-id}/holdings

Request

  • Base URL: https://api.composer.trade (the document declares no server; this is the origin it was published from)
  • URL: https://api.composer.trade/api/v0.1/accounts/{account-id}/holdings
  • Auth: none declared

Path parameters

account-idstring uuid required

Unique identifier (UUID) of the account

Query parameters

position_type'DEFAULT_DIRECT' | 'SYMPHONY' | 'ALL'

Filter holdings by position type. DEFAULT_DIRECT returns only direct trades, SYMPHONY returns only Symphony positions, ALL returns both.

Response

Returns an array of all current holdings in the account including equities, and options positions

tickerstring required
quantitynumber double required
asset_class'CRYPTO' | 'EQUITIES' | 'OPTIONS' required

Example response

[
  {
    "asset_class": "EQUITIES",
    "ticker": "AAPL",
    "quantity": 10
  },
  {
    "asset_class": "CRYPTO",
    "ticker": "CRYPTO::BTC//USD",
    "quantity": 0.43252
  },
  {
    "asset_class": "OPTIONS",
    "ticker": "OPTIONS::AAPL250718C00210000//USD",
    "quantity": 5,
    "options_details": {
      "underlying_asset_symbol": "AAPL",
      "strike_price": 210,
      "expiry": "2025-07-18",
      "delta_dollars": 93.27,
      "contract_type": "CALL"
    }
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.