Create holding
create_holdingRegister a new security holding in a fund for a first-time purchase. For existing holdings, use record_trade.
Instructions
Create a brand-new holding (security/asset) in the fund — use ONLY when a security was purchased that the fund has never held before (check list_holdings first). For buys of an existing holding, use record_trade instead. Note: unlike the record_* tools, this writes the holding directly; the buy transaction itself should still go through record_trade for human review.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Security name, e.g. "Vanguard Australian Shares Index ETF" | |
| notes | No | ||
| 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 acquired | |
| broker_id | No | Broker ID (see list_brokers) | |
| asset_type | No | Asset type by name or category string, e.g. "ETF" or "equity" (see list_asset_types). Defaults to equity. | |
| ticker_symbol | No | Ticker, e.g. "VAS" | |
| acquisition_date | No | Acquisition date as an ISO date, e.g. "2026-05-30" | |
| purchase_price_per_unit | No | Purchase price per unit in AUD |