Portfolio stress (multi-asset, instant)
portfolio_stress_testUSE WHEN you want to stress a portfolio of SPY, TLT, GOLD and BTC across cross-asset regimes. Provide holdings as [{asset, weight}] (weights normalised; GLD accepted for GOLD, BTC-USD for BTC). Returns per regime (baseline / risk_off_crisis / rate_shock): return, worst-episode drawdown, per-leg decomposition and a cross_asset_finding (diversification_intact / hedge_holds / hedge_breaks / shared_drawdown / concentrated_loss), plus sustained drawdowns over the simulated paths. The joint correlation structure, including the bond hedge that can break under rate shocks, comes from a pre-computed substrate, so the call is instant. Optional costs ({rebalance: none|daily|monthly|quarterly|band, annual_costs: {asset: fraction}, transaction_cost_bps}) adds a cost_impact block paired on identical paths. Other tickers: build_portfolio (full tier, needs an access token) in assess mode (portfolios={name:{ticker:weight}}). Descriptive, not advisory.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"holdings": "<holdings>"
},
"name": "portfolio_stress_test"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| costs | No | Optional cost model: {'rebalance': 'monthly', 'transaction_cost_bps': float, 'annual_costs': {ASSET: annual fraction}}. Omit for the frictionless default. | |
| holdings | Yes | Portfolio legs: list of {asset, weight} objects, e.g. [{'asset': 'SPY', 'weight': 0.6}, {'asset': 'TLT', 'weight': 0.4}]. Assets: SPY, TLT, GOLD, BTC (aliases GLD, BTC-USD). Weights are non-negative and normalised to sum to 1; at most 50 legs, no duplicates. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |