Documentation Index
Fetch the complete documentation index at: https://sure-917046f5-docs-backup-restore-clarity.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Managing Investment Accounts
Investment accounts in Sure go beyond simple balance tracking. They help you understand your portfolio through holdings, trades, cost basis tracking, and investment activity labels.
Understanding Holdings
A holding represents your position in a specific security. For example, if you own 50 shares of Apple stock, that’s one holding.
Each holding tracks:
- Security - What you own (stock, ETF, mutual fund, crypto)
- Quantity - How many shares or units you hold
- Price - Current market price per share
- Amount - Total current value (quantity x price)
- Cost Basis - What you originally paid
Recording Trades
Investment accounts support manual trade entry to track your buy and sell activity.
Trade Types
When recording a trade, you can specify:
- Buy: Purchase of securities
- Sell: Sale of securities
- Dividend: Dividend income (recorded as a trade with qty: 0 and price: 0)
- Interest: Interest income (recorded as a trade with qty: 0 and price: 0)
Recording Dividends and Interest
Dividends and interest are recorded as trades to maintain data integrity:
Dividends:
- Require a security selection (the security that paid the dividend)
- Recorded with qty: 0 and price: 0
- Amount represents the dividend payment received
Interest:
- Security selection is optional
- If no security is selected, Sure creates a synthetic cash security for the account
- Recorded with qty: 0 and price: 0
- Amount represents the interest earned
This approach ensures all investment income is properly tracked while maintaining the requirement that trades reference a security.
Transaction Fees
Trades support an optional fee field to track transaction costs:
- Fees are included in the total amount calculation:
qty × price + fee
- Fees default to 0 if not specified
- Useful for tracking brokerage commissions, exchange fees, or other trading costs
For example:
- Buy 10 shares at 100/sharewitha5 fee = $1,005 total
- Sell 10 shares at 110/sharewitha5 fee = $1,095 total (proceeds after fee)
To add a fee to a trade:
- Open the trade form (create or edit)
- Enter the fee amount in the fee field
- The total amount updates automatically to include the fee
Fees are automatically factored into your cost basis calculations and realized gains/losses.
Securities Types
Sure supports various security types:
| Type | Examples |
|---|
| Stocks | Individual company shares (AAPL, GOOGL) |
| ETFs | Exchange-traded funds (SPY, VTI) |
| Mutual Funds | Pooled investment funds |
| Crypto | Bitcoin, Ethereum, other cryptocurrencies |
| Bonds | Fixed-income securities |
Cost Basis Tracking
Cost basis is the original purchase price of your investments. It’s essential for:
- Calculating gains and losses
- Understanding investment performance
- Tax reporting
Cost Basis Sources
Sure tracks cost basis from three sources, in order of priority:
| Priority | Source | Description |
|---|
| 1 (Highest) | Manual | Values you enter directly |
| 2 | Calculated | Computed from your buy trades |
| 3 (Lowest) | Provider | Imported from your financial institution |
This hierarchy ensures your manual entries always take precedence, calculated values override provider data, and provider data is used when nothing else is available.
Setting Cost Basis Manually
You can set cost basis in two ways:
From the Holdings List:
- Navigate to your investment account
- Find the holding in your portfolio
- Click the pencil icon next to the average cost
- Enter either:
- Total cost basis: The total amount you paid for all shares
- Per-share cost: The average price per share
- Click Save
From the Holding Drawer:
- Click on a holding to open its detail drawer
- In the Overview section, click the pencil icon next to “Average Cost”
- Enter the cost basis (total or per-share)
- Click Save
[!TIP]
The cost basis editor provides real-time conversion between total and per-share values. Enter whichever format you have available, and Sure calculates the other automatically.
Lock Protection
When you manually set a cost basis, Sure automatically locks it to prevent automatic updates from overwriting your value. You’ll see a lock icon indicating the value is protected.
This ensures your manual entries remain intact during account syncs.
Unlocking Cost Basis
If you want Sure to recalculate cost basis from your trades:
- Open the holding drawer
- Scroll to the Settings section
- Find “Cost basis locked”
- Click Unlock
After unlocking:
- The lock icon disappears
- Future syncs can update the cost basis
- Calculated values (from trades) will replace the manual value
Recording Trades
Investment accounts support recording various types of trades to track your portfolio activity.
Trade Types
| Type | Description | Security Required |
|---|
| Buy | Purchase of securities | Yes |
| Sell | Sale of securities | Yes |
| Dividend | Dividend payments received | Yes |
| Interest | Interest earned on cash or securities | No (optional) |
Recording Dividends and Interest
Dividends and interest are recorded as trades with zero quantity and zero price, allowing them to be associated with specific securities while maintaining data integrity.
Dividends:
- Require a security selection (the stock/fund paying the dividend)
- Recorded as a trade with qty: 0 and price: 0
- Amount represents the dividend payment received
Interest:
- Security selection is optional
- When no security is selected, Sure creates a synthetic cash security for the account
- Recorded as a trade with qty: 0 and price: 0
- Amount represents the interest earned
To record a dividend or interest payment:
- Navigate to your investment account
- Click + New Trade
- Select Dividend or Interest from the type dropdown
- For dividends: Select the security that paid the dividend
- For interest: Optionally select a security, or leave blank for cash interest
- Enter the amount received
- Set the date
- Click Save
[!NOTE]
Dividends require a security selection, while interest can be recorded without one. When no security is selected for interest, Sure automatically creates a per-account synthetic cash security (kind: cash, offline: true) to maintain data integrity.
Trade Fees
All trades support an optional fee field to track transaction costs:
- Fees are included in the total amount calculation:
total = (qty × price) + fee
- Fees default to 0 if not specified
- Fees are tracked separately for accurate cost basis calculations
Investment Activity Labels
Activity labels help you classify investment transactions. They appear as badges in your transaction list and help you understand your investment activity at a glance.
Recording Dividends and Interest
Dividends and interest are recorded as trades with zero quantity and zero price. This approach maintains data integrity while properly tracking investment income:
- Dividends require a security to be selected (the stock or fund paying the dividend)
- Interest can optionally specify a security, or will use a synthetic cash security for the account
- Both appear in your holdings and trade history
- Both are properly labeled with their respective activity types
- The zero-quantity, zero-price approach preserves the trade model’s required security association
When creating a dividend or interest transaction:
- Select Dividend or Interest from the trade type dropdown
- For dividends: Choose the security paying the dividend (required)
- For interest: Optionally select a security, or leave blank to use the account’s cash position
- Enter the amount received
- The trade is created with qty: 0 and price: 0, maintaining the security association
Trade Fees
All trades support an optional fee field to track transaction costs like brokerage commissions, exchange fees, or other trading expenses.
How Fees Work
- Fees are included in the total transaction amount:
Total = (Quantity × Price) + Fee
- Fees default to 0 if not specified
- Fees can be added when creating or editing trades
- The fee field auto-submits like other trade fields
Adding Fees to Trades
When creating or editing a trade:
- Enter the quantity and price as usual
- Add the fee amount in the Fee field
- The total amount updates automatically to include the fee
- Save the trade
Example: Buying 10 shares at 50witha5 commission:
- Quantity: 10
- Price: $50
- Fee: $5
- **Total: 505∗∗(10×50 + $5)
Fees are particularly important for:
- Accurate cost basis calculations
- Understanding true investment returns
- Tax reporting and record keeping
Available Activity Labels
| Label | Description |
|---|
| Buy | Purchase of securities |
| Sell | Sale of securities |
| Contribution | Money added to the investment account |
| Withdrawal | Money removed from the investment account |
| Dividend | Dividend payments received (recorded as trades with qty: 0) |
| Interest | Interest earned (recorded as trades with qty: 0) |
| Reinvestment | Dividends or distributions reinvested |
| Sweep In | Cash swept into the account |
| Sweep Out | Cash swept out of the account |
| Fee | Account or transaction fees |
| Exchange | Currency or security exchanges |
| Transfer | Internal transfers |
| Other | Miscellaneous transactions |
[!NOTE]
Dividends and interest are recorded as trades with zero quantity and zero price. Dividends require a security selection, while interest can optionally use a synthetic cash security if no specific security is selected.
Setting Labels Manually
- Open a transaction from an investment or crypto account
- Scroll to the Settings section
- Find “Activity type”
- Select a label from the dropdown
- The change saves automatically
Setting Labels with Rules
Create rules to automatically label transactions based on patterns:
- Go to Settings > Rules
- Create a new rule
- Set conditions (e.g., “IF transaction name contains ‘DIVIDEND’”)
- Add action: “Set investment activity label”
- Choose the label (e.g., “Dividend”)
- Save the rule
Example rules:
- IF name contains “DIVIDEND” THEN set label to “Dividend”
- IF name contains “INTEREST” THEN set label to “Interest”
- IF name contains “FEE” THEN set label to “Fee”
[!NOTE]
Internal movement labels (Transfer, Sweep In, Sweep Out, Exchange) are automatically excluded from budget calculations since they represent cash management rather than income or expenses.
Tax Treatment Categories
Investment accounts have different tax implications based on their type:
| Category | Description | Examples |
|---|
| Taxable | Gains taxed when realized | Brokerage, UGMA/UTMA |
| Tax-Deferred | Taxes deferred until withdrawal | 401(k), Traditional IRA, 403(b) |
| Tax-Exempt | Qualified gains are tax-free | Roth IRA, Roth 401(k), ISA |
| Tax-Advantaged | Special tax benefits with conditions | 529 Plan, HSA |
Sure automatically assigns tax treatment based on account subtype, but you can adjust it manually if needed.
Understanding Gains and Losses
Sure helps you track two types of gains:
Unrealized Gains/Losses
Paper gains or losses on holdings you still own:
Unrealized Gain = Current Value - Cost Basis
If you bought 10 shares at 100(1,000 total) and they’re now worth 1,200,youhaveanunrealizedgainof200.
Realized Gains/Losses
Actual gains or losses from securities you’ve sold. These are what matter for taxes.
The Trend indicator on each holding shows your unrealized gain or loss, calculated from your cost basis. If cost basis is unknown (no trades and no manual entry), the trend won’t display.
Crypto-Specific Features
Crypto accounts work similarly to investment accounts but have unique characteristics:
| Subtype | Description | Manual Trades |
|---|
| Wallet | Self-custody or provider-synced | No |
| Exchange | Centralized exchanges (Binance, Coinbase, etc.) | Yes |
- Exchange accounts support manual trade entry, letting you record buys and sells
- Wallet accounts are sync-only, holdings are updated through provider connections
Crypto is taxable by default, though it can be held in tax-advantaged accounts (for example, a self-directed IRA).
Adding Investment Accounts
- Click + Add Account on your dashboard
- Select Investment or Crypto
- Choose the appropriate subtype (see Account Types for all options)
- Enter your account details:
- Account name
- Current balance
- Tax treatment (if different from default)
- Click Create Account
After creating the account, you can add holdings manually or connect a provider to sync them automatically.