rebalance_check
Analyze current portfolio and suggest trades to rebalance toward target allocation. Supports multiple modes including total rebalance, threshold bands, and cash allocation strategies.
Instructions
Buy/sell/hold suggestions to move current holdings toward the target allocation (ASSET_TARGET). There are exactly 4 modes: 'to_total' (rebalance the whole book back to target weights — ALSO deploys new_cash into the rebalance if you pass it) and 'bands' (trade only sleeves that drifted past the 5%/25% threshold — the one mode that IGNORES new_cash); 'fixed_dca' (spread new_cash across the target mix) and 'cash_flow_only' (put new_cash into the most-underweight sleeves) — these two REQUIRE new_cash > 0 and suggest all-HOLD when it is 0. Offline + read-only — it suggests, never trades. A NEW target ticker can't be sized offline (no cached price); those appear under 'unpriced'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | to_total | |
| new_cash | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asof | Yes | ||
| mode | Yes | ||
| note | No | Read-only: figures are derived from your transaction log and the on-disk price cache. Uncached prices are fetched online on demand — a one-time core warm on the first cold call, plus any new ticker you ask about (set ASSET_MCP_OFFLINE=1 to keep it strictly offline); a value still unavailable shows null (n/a), never a guess. This is a view, not financial advice. | |
| new_cash | No | new cash deployed this run: fixed_dca / cash_flow_only REQUIRE it, to_total also deploys it if passed, only bands ignores it. For fixed_dca / cash_flow_only, 0 → all-HOLD. | |
| unpriced | Yes | held/target tickers with no cached price; offline, a NEW target ticker can't be sized — run the CLI online for a full plan | |
| suggestions | Yes | ||
| target_source | No | the ASSET_TARGET file the plan is measured against |