---
title: "Retrieve Market Correlations"
method: GET
path: "/api/market/correlations"
---

# Retrieve Market Correlations

`GET /api/market/correlations`

## Request

- Base URL: `https://api.unusualwhales.com`
- URL: `https://api.unusualwhales.com/api/market/correlations`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/docs/api/market/correlations/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the correlations between a list of tickers. Date must be the current or a past date. If no date is given, returns data for the current/last market day.

## Query parameters

- `interval` string
- `tickers` string, required

## Response `200`

Successful response with a list of correlations.

- CorrelationsResponse
  - `data` Correlation[]
    - `correlation` number, float: The correlation value.
    - `fst` string: The first stock ticker.
    - `max_date` string, date: The latest date of the data points considered.
    - `min_date` string, date: The earliest date of the data points considered.
    - `rows` integer: The number of data points considered.
    - `snd` string: The second stock ticker.

## Other responses

- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api.md) - [All operations](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/revisions/0b37cadfb125?raw)