---
title: "List holdings"
method: GET
path: "/accounts/{account_id}/holdings"
tags: ["Holdings"]
---

# List holdings

`GET /accounts/{account_id}/holdings`

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.

## Path parameters

- `account_id` string, required — Account ID for the account.

## Query parameters

- `date` integer — Integer in YYYYMMDD representing a date.

## Response `200`

Successful response

- object
  - `account_id` string, required — Account ID for the account.
  - `account_number` string, required — Account number for the account.
  - `date` integer, required — Integer in YYYYMMDD representing a date.
  - `sod_equity` number, double, required — Start of day equity.
  - `eod_equity` number, double — For historical holdings, the end of day equity. Omitted for real-time holdings.
  - `timestamp` integer — Milliseconds since epoch.
  - `data` Holding[], required
    - `symbol` string, required
    - `symbol_description` string — Description of the symbol.
    - `asset_class` 'other' | 'currency' | 'equity' | 'option' | 'debt' | 'fund', required — The asset class of the symbol.
    - `quantity` string, required — String representation of quantity.
    - `sod_quantity` string, required — String representation of quantity.

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/clear-street/apis/common-api-models.md) · [All operations](https://skmtc.net/clear-street/apis/common-api-models/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clear-street/common-api-models/revisions/05b4df42c056/schema)