---
title: "Get Ticker Data (Single)"
method: GET
path: "/v2/index_data"
tags: ["Index Data V2"]
---

# Get Ticker Data (Single)

`GET /v2/index_data`

This endpoint allows permissioned users to retrieve ticker/index data with flexible querying options. Data can be queried by full ticker notation or individual components, allowing for broad or specific searches.

**Query Parameter Semantics:**

*   **ticker**: Fully qualified ticker notation in format "{Index}.{Granularity}" (e.g., "OTMS.DAL"). When provided, automatically splits into index and granularity1 components. This is the most specific form.
*   **index**: The base ticker/index identifier only (e.g., "OTMS"). Use this for broader queries across all granularities of an index.
*   **granularity1**: The primary granularity dimension (e.g., "USA", "DAL"). Can be used alone or with index.
*   **granularity\_level**: Additional granularity level filtering (e.g., location codes).

**Flexible Querying Examples:**

*   Specific ticker: \`\`\`ticker=OTMS.DAL\`\`\` → Returns OTMS index with DAL granularity
*   All granularities: \`\`\`index=OTMS\`\`\` → Returns all OTMS data across all granularities
*   Partial granularity: \`\`\`index=OTMS&granularity=DAL\`\`\` → Returns OTMS with XMKT granularity
*   OTMS for all markets: \`\`\`index=OTMS&granularity\_level=XMKT\`\`\` → Returns OTMS with XMKT granularity
*   With level filter: \`\`\`index=OTMS.DAL&granularity\_level=XMKT\`\`\` → Most specific query

**Precedence:** ticker takes precedence as it's most specific. Individual parameters override components parsed from ticker.

**Required Parameters:** start\_date, end\_date, and at least one of (ticker or index) must be provided.

## Query parameters

- `start_date` string, date
- `end_date` string, date
- `ticker` string
- `index` string
- `granularity` string
- `granularity_level` string

## Headers

- `x-api-version` string

## Response `200`

OK

- IndexDataJsonResponse[]
  - `index` string — The ticker symbol/identifier
  - `granularity` string — Specific granularity item
  - `granularity_level` string — Granularity level identifier
  - `data_date` string, date — Date of the data point
  - `data_value` number, double — The value for this data point

---

[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)