Skip to content
Agni Folio Docs

Transactions

A transaction is an event on one of your investments — buying more shares, selling some, receiving a dividend, paying down a loan. Transactions are the source of truth for your portfolio’s cost basis, realised gains, and total return. Edit a transaction and Agni Folio recalculates every derived value automatically.

Transaction types

Section titled “Transaction types”

Adds to a position. Use when you purchase more of an asset you already hold.

Fields: quantity, price per unit, date, fees (optional), notes (optional)

What it does:

  • Increases your position quantity
  • Recalculates your weighted-average cost basis (the price at which your overall position would break even)
  • Records the transaction in the entry’s history

Example: you bought 100 units of a stock at $150 last year, then buy 50 more today at $200. Your new avg cost basis is (100 × $150 + 50 × $200) / 150 = $166.67.

How recalculation works

Section titled “How recalculation works”

Every time you add, edit, or delete a transaction, Agni Folio recomputes the entry’s derived values server-side:

  • Avg cost basis — weighted average across all BUYs minus quantity reduced by SELLs
  • Realised gain/loss — sum across all SELLs
  • Dividend income — sum across all DIVIDENDs
  • Display return — total return as a percentage including dividends and realised gains
  • Outstanding principal (loans only) — original minus principal portions of PAYMENTs

Adding a transaction

Section titled “Adding a transaction”

From any entry’s detail page, click Add Transaction, pick the type, fill in the fields, and save. The entry’s headline metrics update immediately.

A withdrawal or deposit added this way stands on its own. When money left one of your holdings and arrived in another (an FD paid into a bank account, a bank account into a fund), click Move money instead: both sides are saved as one linked step, and you can later see where the money went. See Move money and see where it went.

Editing or deleting

Section titled “Editing or deleting”

Click the edit icon on any transaction row in the entry’s history. Changes trigger recalculation. Same for deletions.

Bulk import via AI

Section titled “Bulk import via AI”

Manual transaction entry is the slowest part of portfolio tracking. Agni Folio offers three AI-powered import paths:

Dedicated import page

Section titled “Dedicated import page”

AI Transaction Import accepts a broker statement in any format:

  • PDF (contract notes, quarterly statements, CAMS / KFintech CAS)
  • CSV and Excel (most brokers offer an export)
  • Images (PNG, JPG, WEBP) of a statement
  • Plain text (paste from a tax form or email)

An AI model extracts every row, maps it to your existing holdings, and presents the results for review. Nothing is saved until you check the rows and click Confirm & Import.

Indian mutual funds: upload your CAMS or KFintech CAS PDF. Each folio becomes its own holding, matched by ISIN and folio number, and next month’s statement updates the same holdings. See Import your CAMS / KFintech CAS statement.

By email

Section titled “By email”

Statements your banks, brokers and fund houses email you can be forwarded to your personal Agni Folio address, by hand or with an automatic rule in your email. AI reads each one, and it waits on the import page until you review and confirm it. See Auto-sync statements by email.

Inside Astra chat

Section titled “Inside Astra chat”

Astra accepts the same statements directly in chat. Paste a PDF text or CSV row, and Astra parses it inline, proposing transactions as a card. Confirm to add. Useful when you’re already chatting with Astra about your portfolio.

What’s next

Section titled “What’s next”