---
title: "OutputRiskCorrelationMatrix"
url: "https://developer-beta.morningstar.com/apis/portfolio-xray-api/versions/4c9879bf-1def-4f49-adea-5a04cd02e29e/schemas/OutputRiskCorrelationMatrix"
---

> Full API specification: https://developer-beta.morningstar.com/apis/portfolio-xray-api/versions/4c9879bf-1def-4f49-adea-5a04cd02e29e.md

# OutputRiskCorrelationMatrix

Correlation matrix data showing pairwise return correlations between holdings and/or the portfolio.

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Portfolio X-Ray API
  version: "1.0"
servers:
  - url: https://www.us-api.morningstar.com
    description: Americas Production
  - url: https://www.apac-api.morningstar.com
    description: APAC Production
  - url: https://www.emea-api.morningstar.com
    description: EMEA Production
components:
  schemas:
    OutputRiskCorrelationItemKey:
      type: object
      properties:
        Id:
          type: integer
          format: int32
        SecurityId:
          type: string
          description: Unique identifier of a security.
        UseExtendedReturns:
          type: boolean
          description: Indicates whether extended return history was used in the
            calculation.
        Type:
          type: string
          description: Indicates whether the item is a portfolio or an individual security.
          enum:
            - Portfolio
            - Security
        CorrelatedItemKey:
          type: array
          items:
            $ref: "#/components/schemas/OutputRiskCorrelatedItemKey"
    OutputRiskCorrelatedItemKey:
      type: object
      properties:
        CorrelatedItemKeyId:
          type: integer
          format: int32
        Type:
          type: string
          description: Indicates whether the correlated item is a portfolio or an
            individual security.
          enum:
            - Portfolio
            - Security
        Value:
          type: number
          format: double
          description: Correlation coefficient between this item and the referenced item.
    OutputRiskCorrelationMatrix:
      description: Correlation matrix data showing pairwise return correlations
        between holdings and/or the portfolio.
      type: object
      properties:
        TrailingTimePeriod:
          type: string
          description: Trailing time period over which correlations are calculated.
          enum:
            - Year3
            - Year5
            - Year10
        DataFrequency:
          type: string
          description: Frequency of data used in the calculation.
          enum:
            - Monthly
        StartDate:
          type: string
          format: date-time
          description: Start date of the correlation calculation period.
        EndDate:
          type: string
          format: date-time
          description: End date of the correlation calculation period.
        Correlations:
          type: array
          items:
            $ref: "#/components/schemas/OutputRiskCorrelationItemKey"
```