Skip to main content
POST
/
quantlib
/
portfolio
/
black-litterman
/
equilibrium
Black-Litterman Equilibrium Returns
curl --request POST \
  --url https://finceptbackend.share.zrok.io/quantlib/portfolio/black-litterman/equilibrium \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "covariance_matrix": [
    [
      0.04,
      0.006,
      0.008,
      0.01
    ],
    [
      0.006,
      0.09,
      0.012,
      0.015
    ],
    [
      0.008,
      0.012,
      0.0625,
      0.018
    ],
    [
      0.01,
      0.015,
      0.018,
      0.16
    ]
  ],
  "market_caps": [
    5000000000,
    3000000000,
    2000000000,
    1000000000
  ],
  "risk_aversion": 2.5
}
'
{
  "success": true,
  "data": {
    "equilibrium_returns": [
      0.075,
      0.115,
      0.095,
      0.145
    ],
    "risk_aversion": 2.5
  }
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Get your key at https://finceptbackend.share.zrok.io/auth/register

Body

application/json
​
covariance_matrix
number[][]
required

Asset covariance matrix (annualized)

Example:
[
  [0.04, 0.006, 0.008, 0.01],
  [0.006, 0.09, 0.012, 0.015],
  [0.008, 0.012, 0.0625, 0.018],
  [0.01, 0.015, 0.018, 0.16]
]
​
market_caps
number[]
required

Market capitalizations for each asset (in any consistent currency unit). Will be normalized to weights.

Example:
[
  5000000000,
  3000000000,
  2000000000,
  1000000000
]
​
risk_aversion
number
default:2.5

Market risk aversion parameter (δ). Typical values range from 2.0 to 4.0. Higher values imply more conservative risk preferences.

Required range: 0.1 <= x <= 10
Example:

2.5

Response

Equilibrium returns successfully computed

​
success
boolean
Example:

true

​
data
object