portfolio · wire operation
Propose a rebalance (a proposal, never an order)
Fold the ledger snapshot to its state, mark it from the market snapshot, and propose the trades that take the portfolio to the policy targets (or only the drifted ones) under the policy limits, lot sizes, minimum notional, transaction-cost estimates, and an optional external flow. The result is proposePortfolioRebalance(...) verbatim: weights before and after, the cash summary, the trades with their estimates, the objective, and every target it could not resolve. Read-only by construction — it returns a proposal and places nothing. Opt-in (portfolioPack).
totalfinance.portfolio.rebalance_proposal- MCP tool name
- totalfinance_portfolio_rebalance_proposal
- Pack / profiles
- portfolio / full, portfolio
- Default discovery
- Opt-in (select its pack or profile)
- Required capabilities
- trade:propose
- Effects / authorization
- none / none
- Cost / cancellation
- medium / Do not assume inline interruption
- Handle-eligible inputs
- ledger, market
- Idempotency
- not-applicable
Input schema
| Field | Type | Meaning |
|---|---|---|
ledgerRequired | object | A serialized portfolio ledger (totalfinance.portfolio-ledger, the FC7 JSON form) |
asOfRequired | number | string | The valuation instant the proposal is sized at |
marketRequired | object | A Gate B market snapshot (totalfinance.market-snapshot); its interior is re-validated by the read door |
currencyConversionsOptional | object[] | — |
policyRequired | object | Targets come from the policy (inline targets or a model) |
instrumentClassificationOptional | object | Identity metadata per instrument for grouping; unknown instruments group as unclassified |
scopeRequired | "to-target" | "drift-only" | 'to-target' trades every target to weight; 'drift-only' trades only targets outside their band |
externalFlowOptional | object | A contribution (positive) or withdrawal (negative) the proposal sizes around |
tradingAccountIdOptional | string | — |
averageDailyVolumesOptional | object | — |
lotSizesOptional | object | — |
defaultLotSizeOptional | number | — |
minimumNotionalOptional | number | — |
transactionCostsOptional | object | — |
Complete JSON Schema
Loading…
Output schema
| Field | Type | Meaning |
|---|---|---|
asOfRequired | number | — |
baseCurrencyRequired | string | — |
netAssetValueRequired | number | — |
netAssetValueAfterFlowRequired | number | — |
weightsRequired | object | — |
cashRequired | object | — |
tradesRequired | object[] | — |
estimatesRequired | object | — |
objectiveRequired | object | — |
unresolvedTargetsRequired | object[] | — |
assumptionsRequired | object | Applied conventions |
diagnosticsRequired | object | Engine, method, warnings |
Complete JSON Schema
Loading…