---
title: "Ticker Statistics"
method: POST
path: "/v2/index_data/statistics"
tags: ["Index Data V2"]
---

# Ticker Statistics

`POST /v2/index_data/statistics`

This endpoint allows permissioned users to get statistical aggregations of ticker/security data over specified time periods. The statistics can be aggregated by various time periods including summary (all data in range), weekly, monthly, quarterly, yearly, or week-to-date.

This endpoint handles the following input fields:

*   tickers: a list of security identifiers to retrieve statistics for, required
*   start\_date: the earliest date of the range over which statistics are being requested (YYYY-MM-DD), required
*   end\_date: the most recent date of the range over which statistics are being requested (YYYY-MM-DD), required
*   aggregation: time period for aggregation - 'SUMMARY', 'WEEKLY', 'MONTHLY', 'QUARTERLY', 'YEARLY', or 'WTD' (week-to-date), required

Here are the output fields returned in a successful call:

*   security\_id: the ticker/security identifier
*   min\_data\_date: the start date of the aggregation period
*   max\_data\_date: the end date of the aggregation period
*   min\_value: the minimum value in the period
*   median\_value: the median value in the period
*   average\_value: the average (mean) value in the period
*   max\_value: the maximum value in the period
*   data\_point\_count: the number of data points included in the aggregation
*   aggregation: the aggregation type used for this period

## Headers

- `x-api-version` string

## Request body

- TickerAggregationJsonRequest — Aggregation request for ticker security data.
  - `tickers` string[]
  - `start_date` string, date
  - `end_date` string, date
  - `aggregation` 'Summary' | 'Weekly' | 'Monthly' | 'Quarterly' | 'Yearly' | 'WTD'

## Response `200`

OK

- IndexAggregationJsonResponse[]
  - `security_id` string — Security identifier
  - `min_data_date` string, date — Start date of the aggregation period
  - `max_data_date` string, date — End date of the aggregation period
  - `min_value` number, double — Minimum value in the period
  - `median_value` number, double — Median value in the period
  - `average_value` number, double — Average (mean) value in the period
  - `max_value` number, double — Maximum value in the period
  - `data_point_count` integer — Number of data points included in the aggregation
  - `aggregation` 'Summary' | 'Weekly' | 'Monthly' | 'Quarterly' | 'Yearly' | 'WTD' — Aggregation type (e.g., "monthly", "daily", "yearly")

---

[API](https://skmtc.net/freightwaves/apis/sonar-api.md) · [All operations](https://skmtc.net/freightwaves/apis/sonar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/freightwaves/sonar-api/revisions/3a995f316cda/schema)