---
title: "Empirical Conditional Value At Risk"
method: POST
path: "/portfolios/analysis/value-at-risk/conditional/estimation/empirical"
tags: ["Portfolio Analysis / Risk Measures / Conditional Value At Risk Estimation"]
---

# Empirical Conditional Value At Risk

`POST /portfolios/analysis/value-at-risk/conditional/estimation/empirical`

## Request

- Base URL: `https://api.portfoliooptimizer.io/v1`
- URL: `https://api.portfoliooptimizer.io/v1/portfolios/analysis/value-at-risk/conditional/estimation/empirical`
- Auth: API key in header `X-API-Key`

Compute the empirical conditional value at risk of a portfolio.

References
* [Wikipedia, Value at risk](https://en.wikipedia.org/wiki/Value_at_risk)
* [Acerbi, C. and Tasche, D. (2002), Expected Shortfall: A Natural Coherent Alternative to Value at Risk. Economic Notes, 31: 379-388](https://onlinelibrary.wiley.com/doi/abs/10.1111/1468-0300.00091)

## Request body

- object
  - `confidenceLevel` number: The confidence level
  - `portfolios` object[], required
    - `portfolioValues` number[], required: portfolioValues[t] is the value of the portfolio at the time t

## Response `200`

OK

- object
  - `portfolios` object[], required
    - `portfolioConditionalValueAtRisk` number, required: The empirical conditional value at risk of the portfolio, in (logarithmic return) percentage

## Changes

- **2026-02-08** `ac51d393c9a9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/portfoliooptimizer/apis/portfolio-optimizer/changes/portfolios/analysis/value-at-risk/conditional/estimation/empirical/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.dev/portfoliooptimizer/apis/portfolio-optimizer/revisions/9d075aa717bf?raw)