matlab/matlab-agentic-toolkit / skills-catalog/computational-finance/matlab-optimize-portfolio
matlab-optimize-portfolio
VerifiedFormulate and solve portfolio optimization problems in MATLAB. Routes to the Financial Toolbox Portfolio object for mean-variance (Markowitz), minimum- variance, target-return, maximum Sharpe ratio, and efficient frontier problems with bounds, budget, group, turnover, tracking-error, or cardinality constraints; or to the problem-based framework (optimproblem/optimvar/solve) when constraints exceed what Portfolio can express: integer round lots, whole shares, per-lot or fixed commissions, minimum trade sizes, semi-integer positions, wash-sale rules, realized capital-gains caps, tax-loss harvesting, asymmetric or bucketed transaction- cost caps, or a custom efficient frontier over such constraints. Use when users ask about portfolio optimization, when they attempt quadprog, fmincon, intlinprog, or ga for a portfolio problem, or when code rounds Portfolio weights to whole shares or lots.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.0 KB |
| manifest.yaml | config | 762 B |
| references/portfolio-object.md | markdown | 6.3 KB |
| references/portfolio-object/examples.md | markdown | 8.8 KB |
| references/portfolio-object/formulation-max-sharpe.md | markdown | 3.6 KB |
| references/portfolio-object/formulation-mean-variance.md | markdown | 3.7 KB |
| references/portfolio-object/reference-core.md | markdown | 6.8 KB |
| references/problem-based.md | markdown | 19.2 KB |
| references/problem-based/custom-frontier.md | markdown | 9.3 KB |
| references/problem-based/disjunctive-big-m.md | markdown | 5.9 KB |
| references/problem-based/mip-recognition.md | markdown | 4.0 KB |
| references/problem-based/problem-based-framework.md | markdown | 6.1 KB |
| references/problem-based/problem-data-hygiene.md | markdown | 7.4 KB |
| references/problem-based/tax-aware-constraints.md | markdown | 5.0 KB |
| references/problem-based/trade-aux-variables.md | markdown | 5.7 KB |
references/portfolio-object/formulation-max-sharpe.md
View on GitHub# Find the Maximum Sharpe Ratio Portfolio
## Problem Statement
Maximize the Sharpe ratio (risk-adjusted return):
```
maximize (μ'w - rf) / sqrt(w' * Σ * w)
subject to sum(w) = 1 (fully invested)
w >= 0 (long-only, optional)
additional constraints
```
This is a nonlinear objective (ratio of linear over square root of quadratic). The Portfolio object reformulates it internally as a QP via variable substitution.
## When This Formulation Applies
- User wants to **maximize the Sharpe ratio**
- User asks about the **tangency portfolio** or **optimal risk-adjusted portfolio**
- User wants the **Capital Market Line (CML)** tangent point
- User is trying to use fmincon to maximize return/risk ratio
## Key Method: `estimateMaxSharpeRatio`
### Direct method (default, recommended)
```matlab
weights = estimateMaxSharpeRatio(p);
```
### With buy/sell information
```matlab
[weights, buy, sell] = estimateMaxSharpeRatio(p);
% buy/sell relative to p.InitPort
```
### Iterative method (required for cardinality/semicontinuous constraints)
```matlab
weights = estimateMaxSharpeRatio(p, 'Method', 'iterative');
```
## Algorithm (Direct Method)
The direct method transforms the nonlinear Sharpe ratio into a QP:
1. Substitution: t = 1/(μ'x - rf), y = t*x
2. Solve: minimize y'Σy subject to μ'y - rf*sum(y) = 1 and transformed constraints
3. Recover: x* = y* / sum(y*)
This yields a global optimum in one solve. The iterative method instead evaluates Sharpe ratio at many points along the frontier using `fminbnd` — slower but handles discrete constraints.
## Typical Workflow
```matlab
% 1. Setup (risk-free rate is important for Sharpe ratio)
p = Portfolio('AssetMean', mu, 'AssetCovar', Sigma, 'RiskFreeRate', rf);
p = setDefaultConstraints(p);
% 2. Solve
weights = estimateMaxSharpeRatio(p);
% 3. Analyze
[risk, ret] = estimatePortMoments(p, weights);
sharpe = estimatePortSharpeRatio(p, weights);
fprintf('Return: %.4f, Risk: %.4f, Sharpe: %.4f\n', ret, risk, sharpe);
% 4. Visualize on frontier
wFrontier = estimateFrontier(p, 20);
plotFrontier(p, wFrontier);
hold on
plot(risk, ret, 'r*', 'MarkerSize', 12);
legend('Efficient Frontier', 'Max Sharpe Portfolio');
hold off
```
## Common Pitfalls
1. **User writes their own objective function** — The Sharpe ratio is nonlinear. Users who try fmincon directly often hit convergence issues or local optima. `estimateMaxSharpeRatio` uses the variable substitution trick to get a global optimum via QP.
2. **Negative excess returns** — If all asset means are below the risk-free rate, maximizing Sharpe ratio is ill-defined (the "best" portfolio has the least negative Sharpe). Warn the user.
3. **Missing risk-free rate** — Defaults to 0. If the user has a nonzero risk-free rate, they must set it on the Portfolio object — either at construction or via property assignment:
```matlab
p = Portfolio('AssetMean', mu, 'AssetCovar', Sigma, 'RiskFreeRate', rf);
% or after construction:
p.RiskFreeRate = rf;
```
**Do NOT pass `'RiskFreeRate'` as an argument to `estimateMaxSharpeRatio`** — it only accepts `'Method'` and `'TolX'`.
4. **Cardinality/semicontinuous constraints with default method** — These need `'Method','iterative'`. MATLAB auto-selects it with a warning if omitted, but specifying it explicitly is cleaner and avoids the warning.
5. **Short selling** — To allow short positions, replace `setDefaultConstraints` with explicit budget and bound constraints:
```matlab
p = setBudget(p, 1, 1);
p = setBounds(p, -1, 1);
```
----
Copyright 2026 The MathWorks, Inc.
----
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |