---
title: "Retrieve Aggregate Positions"
method: GET
path: "/v1/reporting/eod/aggregate_positions"
tags: ["Reporting"]
---

# Retrieve Aggregate Positions

`GET /v1/reporting/eod/aggregate_positions`

This API endpoint provides reporting data to partners for aggregate common stock and crypto positions across their account base. Partners can view historical snapshots of their holding across their entire account base. Please note that this API utilizes an 8:00 pm (EST) cutoff which aligns with the end of the Securities extended hours trading session as well as Alpaca's 24 hour Crypto trading window. Additionally, the endpoint supports indexing to help the partner efficiently filter by key information including date and symbol while being able to include or remove firm accounts.

## Query parameters

- `date` string, date, required
- `symbols` string
- `firm_accounts` string

## Response `200`

Array of objects, each object pertains to the date specified in the request and a unique asset. See parameters below. Notes: Returns an empty array for non-trading days, assets with no positions are omitted.

- AggregatePositionResponse[]
  - `asset_type` 'us_equity' | 'us_option' | 'crypto' | 'ipo' — This represents the category to which the asset belongs to. It serves to identify the nature of the financial instrument, with options including "us_equity" for U.S. equities, "us_option" for U.S. options, "crypto" for cryptocurrencies, and "ipo" for IPO indications of interest. This `asset_class: ipo` value is distinct from the assets API `attributes: ["ipo"]` flag.
  - `closing_price` string, decimal — EOD asset price per share at session close
  - `cusip` string, decimal — Cusip (9 digits, can start with 0's)
  - `long_market_value` string, decimal — Aggregate notional dollar amount of the partner's long positions
  - `long_qty` string, decimal — Aggregate number of shares that the partner is long
  - `num_accounts` integer — Number of accounts that have a position in this asset (either long or short)
  - `short_market_value` string, decimal — Aggregate notional dollar amount of the partner's short positions
  - `short_qty` string, decimal — Aggregate number of shares that the partner is short
  - `symbol` string — Symbol of asset

---

[API](https://skmtc.net/alpacahq/apis/gift-city-extensions-api.md) · [All operations](https://skmtc.net/alpacahq/apis/gift-city-extensions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alpacahq/gift-city-extensions-api/revisions/62e3378bb273/schema)