Update holding
update_holdingEdit an existing holding to correct a property or lump-sum asset cost base via purchase_price, or fix metadata such as ticker, name, acquisition date and status; supply only the fields to change.
Instructions
Edit an existing holding's fields — most usefully to correct a property (or other lump-sum asset's) cost base via purchase_price, or to fix metadata such as a ticker, name, exchange, acquisition date, sector or status. Find the holding via list_holdings; only supply the fields you want to change. IMPORTANT: for equities that have a buy/sell trade history, cost base and quantity are derived from the trade ledger, so purchase_price / purchase_price_per_unit / quantity set here are IGNORED for them — adjust the underlying trades with record_trade instead. For property and other quantity-less lump-sum assets, cost base = purchase_price plus any stamp_duty / legal_fees / broker_fee_buy / other_purchase_costs. The edit is audited. Amounts in AUD unless currency says otherwise.
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": {
"fund_id": "<fund_id>",
"holding_id": "<holding_id>"
},
"name": "update_holding"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hin | No | Holder Identification Number | |
| name | No | Security/asset name | |
| notes | No | ||
| sector | No | Sector classification | |
| status | No | Holding status, e.g. "active" or "sold" | |
| fund_id | Yes | Fund ID (discover via whoami or list_funds) | |
| currency | No | Currency code (default "AUD") | |
| exchange | No | Exchange, e.g. "ASX" | |
| quantity | No | Units held (ignored for equities with a trade history) | |
| broker_id | No | Broker ID (see list_brokers) | |
| reasoning | No | Why you are making this change — recorded on the audit log entry for this write | |
| asset_type | No | Asset type by name or category, e.g. "ETF" or "equity" (see list_asset_types) | |
| face_value | No | Face value in AUD (cost base driver for fixed-income holdings) | |
| holding_id | Yes | Holding to edit (find via list_holdings) | |
| legal_fees | No | Legal fees on acquisition in AUD (adds to cost base) | |
| stamp_duty | No | Stamp duty on acquisition in AUD (adds to cost base) | |
| external_ref | No | Your stable ID for this write (e.g. a statement line or document reference). Repeating a call with the same external_ref replays the first result instead of writing twice. | |
| ticker_symbol | No | Ticker, e.g. "VAS" | |
| broker_fee_buy | No | Acquisition brokerage in AUD (adds to cost base) | |
| purchase_price | No | Total purchase price in AUD — drives cost base for property and other lump-sum (quantity-less) assets | |
| share_registry | No | Share registry: "computershare", "mufg" (MUFG Corporate Markets, formerly Link Market Services), "automic", "boardroom", "advanced", "xcend" or "other". Left out, it is looked up from the ticker when one is on file. | |
| acquisition_date | No | Acquisition date as an ISO date, e.g. "2026-05-30" | |
| current_price_date | No | Date of the current price as an ISO date, e.g. "2026-05-30" | |
| other_purchase_costs | No | Other acquisition costs in AUD (adds to cost base) | |
| current_price_per_unit | No | Current price per unit in AUD | |
| purchase_price_per_unit | No | Purchase price per unit in AUD (ignored for equities with a trade history) |