CLclear-street
Holdings

List holdings

Changed on

List holdings for a given account, filtered on the given query parameters. This endpoint will return either historical or real-time holdings directly from our custodial systems. Positions returned here are can be different than positions returned from the Execution API. While the Execution API returns positions based on trading activity within Studio, our custodial system returns all positions regardless of where trades occur.

get/accounts/{account_id}/holdings

Request

  • Base URL
    https://api.clearstreet.io/studio/v2
  • Auth
    HTTP bearer

Path parameters

account_idstring required

Account ID for the account.

Example:100000

Query parameters

dateinteger

Integer in YYYYMMDD representing a date.

Example:20240101

Response

Successful response

account_idstring required

Account ID for the account.

account_numberstring required

Account number for the account.

dateinteger required

Integer in YYYYMMDD representing a date.

sod_equitynumber double required

Start of day equity.

eod_equitynumber double

For historical holdings, the end of day equity. Omitted for real-time holdings.

timestampinteger

Milliseconds since epoch.

Example response

{
  "account_id": "100000",
  "account_number": "ACC0001",
  "date": 20240101,
  "data": [
    {
      "symbol": "AAPL",
      "quantity": "100",
      "sod_quantity": "100"
    }
  ]
}

Changes