---
title: "Turbulence Index"
method: POST
path: "/assets/indicators/turbulence-index"
tags: ["Assets / Indicators"]
---

# Turbulence Index

`POST /assets/indicators/turbulence-index`

Compute the turbulence index associated to a universe of assets, as well as its per-asset contributions.

References
* [M. Kritzman, Y. Li, Skulls, Financial Turbulence, and Risk Management,Financial Analysts Journal, Volume 66, Number 5, Pages 30-41, Year 2010](https://www.tandfonline.com/doi/abs/10.2469/faj.v66.n5.3)
* [Kinlaw, W., Turkington, D. Correlation surprise. J Asset Manag 14, 385–399 (2013)](https://link.springer.com/article/10.1057/jam.2013.27)

## 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 over an historical reference period
    - number[]
  - `assetsMeanReturns` number[], required — assetsMeanReturns[i] is the mean return of asset i over an historical reference period, in percentage
  - `assetsReturns` number[], required — assetsReturns[i] is the return of asset i over a period different from the historical reference period in the same frequency as assetsMeanReturns[i], in percentage

## Response `200`

OK

- object
  - `assetsTurbulenceIndex` number, required — the turbulence index of the universe of assets
  - `assetsMarginalTurbulenceIndexContributions` number[], required — assetsMarginalTurbulenceIndexContributions[i] is the marginal contribution of the asset i to the Turbulence Index
  - `assetsTotalTurbulenceIndexContributions` number[], required — assetsTotalTurbulenceIndexContributions[i] is the total contribution of the asset i to the Turbulence Index
  - `assetsRelativeTurbulenceIndexContributions` number[] — assetsRelativeTurbulenceIndexContributions[i] is the relative contribution of the asset i to the Turbulence Index, in percentage; assetsRelativeTurbulenceIndexContributions is not provided when assetsTurbulenceIndex is equal to 0

## Changes

- **2026-08-31** `d047148d28bd` — 3 info
  - added the optional property `assetsRelativeTurbulenceIndexContributions` to the response with the `200` status
  - added the required property `assetsMarginalTurbulenceIndexContributions` to the response with the `200` status
  - added the required property `assetsTotalTurbulenceIndexContributions` to the response with the `200` status

[Change history](https://skmtc.dev/portfoliooptimizer/apis/portfolio-optimizer/changes/assets/indicators/turbulence-index/post.md)

---

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