Record trade
record_tradeRecord a buy or sell trade directly to your SMSF ledger with immediate write and no review step. Use idempotency keys to avoid duplicates.
Instructions
Record a buy or sell directly to your SMSF ledger. This writes immediately — there is no review step. Use whenever a trade is found in an email, contract note or conversation. Identify the holding by ticker or holding_id; the holding must already exist (use create_holding first if it doesn't). Always pass external_ref when the source has a stable ID (e.g. email message id + ticker + date) — it is an idempotency key, so re-running the same import will not create duplicates. Pass reasoning to record why (it is saved on the ledger entry for the audit trail). Amounts in AUD unless currency says otherwise.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | ||
| ticker | No | Ticker symbol of the holding (preferred way to identify it) | |
| fund_id | Yes | Fund ID (discover via whoami or list_funds) | |
| currency | No | Currency code (default "AUD") | |
| quantity | No | Units bought/sold | |
| reasoning | No | Why this trade is recorded (cite the source) — saved to the audit trail | |
| broker_fee | No | Brokerage fee | |
| holding_id | No | Holding ID, if already known | |
| external_ref | No | Idempotency key derived from the source, e.g. '<email-message-id>:VAS:2026-05-30' | |
| total_amount | Yes | Total consideration (AUD unless currency set) | |
| price_per_unit | No | Price per unit | |
| transaction_date | Yes | Trade date as an ISO date, e.g. "2026-05-30" | |
| transaction_type | Yes | Trade direction |