Skip to content
TotalFinance

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

FieldTypeMeaning
ledgerRequiredobjectA serialized portfolio ledger (totalfinance.portfolio-ledger, the FC7 JSON form)
asOfRequirednumber | stringThe valuation instant the proposal is sized at
marketRequiredobjectA Gate B market snapshot (totalfinance.market-snapshot); its interior is re-validated by the read door
currencyConversionsOptionalobject[]—
policyRequiredobjectTargets come from the policy (inline targets or a model)
instrumentClassificationOptionalobjectIdentity 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
externalFlowOptionalobjectA contribution (positive) or withdrawal (negative) the proposal sizes around
tradingAccountIdOptionalstring—
averageDailyVolumesOptionalobject—
lotSizesOptionalobject—
defaultLotSizeOptionalnumber—
minimumNotionalOptionalnumber—
transactionCostsOptionalobject—
Complete JSON Schema

Loading…

Output schema

FieldTypeMeaning
asOfRequirednumber—
baseCurrencyRequiredstring—
netAssetValueRequirednumber—
netAssetValueAfterFlowRequirednumber—
weightsRequiredobject—
cashRequiredobject—
tradesRequiredobject[]—
estimatesRequiredobject—
objectiveRequiredobject—
unresolvedTargetsRequiredobject[]—
assumptionsRequiredobjectApplied conventions
diagnosticsRequiredobjectEngine, method, warnings
Complete JSON Schema

Loading…