# Portfolio Construction — fintech-algorithms

> 20 algorithms in 4 families, sliced out of the
> fintech-algorithms reference. Zero-dependency TypeScript: plain arrays and objects in,
> plain values out. This file covers D14 only.

D14 · 20 topics · 4 families · 0 verified
Install: npm install fintech-algorithms
Agent skill (install it rather than re-deriving this file): npx skills add IslamBaraka90/Fintech-Algorithms-Library
  what it is: https://docs.thefintechbuilder.com/guides/agent-skill/
Source: fintech-algorithms@0.13.2 · payload schema 2.0.0
What changed in each release: https://docs.thefintechbuilder.com/changelog/
Reference payload: https://docs.thefintechbuilder.com/reference/payload.json
Version endpoint: https://docs.thefintechbuilder.com/version.json
Domain page: https://docs.thefintechbuilder.com/portfolio-construction/
Full index (717 topics across 19 domains): https://docs.thefintechbuilder.com/llms.txt

Verification tiers:
- verified — the worked example is the figure published in the algorithm's article, replayed
  and asserted by the test suite on every run. The arithmetic cannot drift without the build
  failing. Treat the numbers as reproducible.
- contract — the module loads, the entry point is callable and its declared signature matches
  the compiled code. The example is real captured output, but no independently published
  figure asserts it. Treat the shape as reliable and the numbers as unattested.
Full explanation: https://docs.thefintechbuilder.com/guides/verification/

Each entry: name — signature — archetype — verification tier — docs URL
From the docs URL, mechanically:
  import subpath — swap the https://docs.thefintechbuilder.com/ prefix for fintech-algorithms/ and drop the trailing slash
  markdown page  — append index.md; same contract as the HTML page, a fraction of the bytes

## D14-F01 — Mean-Risk Optimization
https://docs.thefintechbuilder.com/portfolio-construction/mean-risk-optimization/

- Markowitz Mean-Variance — `markowitzMeanVariance(assetIdsInput, muInput, covarianceInput, targetReturnInput, options)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/mean-risk-optimization/markowitz-mean-variance/
- Global Minimum Variance — `globalMinimumVariance(assetIdsInput, covarianceInput, options)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/mean-risk-optimization/global-minimum-variance/
- Maximum Sharpe Ratio — `maximumSharpe(assetIdsInput, muInput, covarianceInput, riskFreeReturnInput, options)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/mean-risk-optimization/maximum-sharpe-ratio/
- Mean-CVaR Optimization — `meanCvar(assetIdsInput, returnsInput, probabilitiesInput, betaInput, gammaInput, options)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/mean-risk-optimization/mean-cvar-optimization/
- Mean-Absolute-Deviation Optimization — `meanMad(assetIdsInput, returnsInput, probabilitiesInput, targetReturnInput, options)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/mean-risk-optimization/mean-absolute-deviation-optimization/

## D14-F02 — Risk Allocation
https://docs.thefintechbuilder.com/portfolio-construction/risk-allocation/

- Inverse-Volatility Weighting — `inverseVolatilityWeights(assetIds, standaloneVolatilities)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/risk-allocation/inverse-volatility-weighting/
- Equal Risk Contribution — `equalRiskContributionWeights(assetIds, covariance)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/risk-allocation/equal-risk-contribution/
- Risk Budgeting — `riskBudgetingWeights(assetIds, covariance, riskBudgets)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/risk-allocation/risk-budgeting/
- Hierarchical Risk Parity — `hierarchicalRiskParityWeights(assetIds, covariance)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/risk-allocation/hierarchical-risk-parity/
- Hierarchical Equal Risk Contribution — `hierarchicalEqualRiskContributionWeights(assetIds, covariance, clusterCount)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/risk-allocation/hierarchical-equal-risk-contribution/

## D14-F03 — Bayesian and Robust Allocation
https://docs.thefintechbuilder.com/portfolio-construction/bayesian-and-robust-allocation/

- Black-Litterman — `blackLittermanAllocate(input)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/bayesian-and-robust-allocation/black-litterman/
- Resampled Efficient Frontier — `resampledEfficientFrontier(returns, resampleIndices, ranks)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/bayesian-and-robust-allocation/resampled-efficient-frontier/
- Robust Mean-Variance — `robustMeanVariance(mean, covariance, uncertaintyShape, kappa, riskPenalty, maxIterations, tolerance)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/bayesian-and-robust-allocation/robust-mean-variance/
- Distributionally Robust Portfolio — `distributionallyRobustPortfolio(mean, covariance, lossThreshold, returnFloor, tolerance, maxIterations)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/bayesian-and-robust-allocation/distributionally-robust-portfolio/
- Kelly Allocation — `kellyAllocation(returns, probabilities, maxIterations, tolerance)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/bayesian-and-robust-allocation/kelly-allocation/

## D14-F04 — Practical Constraints
https://docs.thefintechbuilder.com/portfolio-construction/practical-constraints/

- Turnover-Constrained Optimization — `solveTurnoverConstrainedMarkowitz(mu, covariance, lambdaRisk, w0, tau, options)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/practical-constraints/turnover-constrained-optimization/
- Transaction-Cost-Aware Optimization — `optimizeTransactionCostAware(mu, covariance, lambdaRisk, x0, buyCost, sellCost, options)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/practical-constraints/transaction-cost-aware-optimization/
- Cardinality-Constrained Portfolio — `optimizeCardinalityConstrained(mu, covariance, lambdaRisk, current, K, options)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/practical-constraints/cardinality-constrained-portfolio/
- Long/Short Gross-Net Constraints — `optimizeGrossNetConstrained(mu, covariance, lambdaRisk, netMin, netMax, grossMax, options)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/practical-constraints/long-short-gross-net-constraints/
- Tax-Aware Portfolio Optimization — `optimizeTaxAwareTrade(holdingsInit, benchmark, expectedReturn, riskMatrix, prices, lots, tradeDate, options)` — record-transform — contract — https://docs.thefintechbuilder.com/portfolio-construction/practical-constraints/tax-aware-portfolio-optimization/