---
title: "Drawdown Function"
method: POST
path: "/portfolios/analysis/drawdowns"
tags: ["Portfolio Analysis / Drawdowns"]
---

# Drawdown Function

`POST /portfolios/analysis/drawdowns`

Compute the drawdown function of a portfolio.

References
* [Alexei Chekhlov & Stanislav Uryasev & Michael Zabarankin, 2005. Drawdown Measure In Portfolio Optimization, International Journal of Theoretical and Applied Finance (IJTAF), World Scientific Publishing Co. Pte. Ltd., vol. 8(01), pages 13-58](https://www.worldscientific.com/doi/abs/10.1142/S0219024905002767)

## Request body

- object
  - `portfolios` object[], required
    - `portfolioReturns` number[] — portfolioReturns[t] is the arithmetic return of the portfolio at the time t; exclusive with portfolioValues
    - `portfolioValues` number[] — portfolioValues[t] is the value of the portfolio at the time t; exclusive with portfolioReturns

## Response `200`

OK

- object
  - `portfolios` object[], required
    - `portfolioDrawdowns` number[], required — portfolioDrawdowns[t] is the value of the drawdown function at the time t

---

[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/versions/479fd4ac44aa/schema)