---
title: "Diversification Ratio Contributions"
method: POST
path: "/portfolios/analysis/contributions/diversification-ratio"
tags: ["Portfolio Analysis / Contributions"]
---

# Diversification Ratio Contributions

`POST /portfolios/analysis/contributions/diversification-ratio`

Perform a Diversification Ratio contribution analysis of a portfolio.

References
* [Steiner, Andreas, Portfolio Insights from a Contribution Analysis of the Diversification Ratio](https://papers.ssrn.com/sol3/papers.cfm?abstract_id=5588193)

## Request body

- object
  - `assets` integer, required — The number of assets
  - `assetsCovarianceMatrix` array[], required — assetsCovarianceMatrix[i][j] is the covariance between the asset i and the asset j
    - number[]
  - `assetsGroups` array[]
    - integer[] — assetsGroups[k] is the indexes of the assets belonging to the assets group k
  - `portfolios` object[], required
    - `assetsWeights` number[], required — assetsWeights[i] is the weight of the asset i in the portfolio, in percentage

## Response `200`

OK

- object
  - `portfolios` object[], required
    - `assetsMarginalDiversificationRatioContributions` number[], required — assetsMarginalDiversificationRatioContributions[i] is the marginal Diversification Ratio contribution of the asset i to the Diversification Ratio of the portfolio
    - `assetsRelativeDiversificationRatioContributions` number[] — assetsRelativeDiversificationRatioContributions[i] is the relative Diversification Ratio contribution of the asset i to the Diversification Ratio of the portfolio, in percentage; assetsRelativeDiversificationRatioContributions is not provided when the Diversification Ratio of the portfolio is equal to 0
    - `assetsTotalDiversificationRatioContributions` number[], required — assetsTotalDiversificationRatioContributions[i] is the total Diversification Ratio contribution of the asset i to the Diversification Ratio of the portfolio
    - `assetsGroupsRelativeDiversificationRatioContributions` number[] — assetsGroupsRelativeDiversificationRatioContributions[k] is the relative Diversification Ratio contribution of the group of assets k to the Diversification Ratio of the portfolio, in percentage; assetsGroupsRelativeDiversificationRatioContributions is not provided when the Diversification Ratio of the portfolio is equal to 0
    - `assetsGroupsTotalDiversificationRatioContributions` number[] — assetsGroupsTotalDiversificationRatioContributions[k] is the total Diversification Ratio contribution of the group of assets k to the Diversification Ratio of the portfolio

---

[API](https://skmtc.net/portfoliooptimizer/apis/portfolio-optimizer.md) · [All operations](https://skmtc.net/portfoliooptimizer/apis/portfolio-optimizer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/portfoliooptimizer/portfolio-optimizer/revisions/dee9caba1913/schema)