Help & Documentation

Everything you need to know about tracking your precious metals collection with theStackers

This application uses real-time spot prices to calculate the current value of your metals inventory. Prices are updated regularly throughout the day.

Site Overview

theStackers Tracker consists of four main sections to help you manage your precious metals portfolio:

Dashboard

  • Total portfolio value overview
  • Current profit/loss tracking
  • Interactive charts for inventory growth
  • Spot price history visualization
  • Portfolio value trends over time
  • Quick action buttons

Silver Inventory

  • View your complete silver collection
  • Add, edit, and delete items
  • Track premiums and quantities
  • Record sales and track profits
  • Export data to CSV
  • Real-time value calculations

Gold Inventory

  • View your complete gold collection
  • Add, edit, and delete items
  • Track premiums and quantities
  • Record sales and track profits
  • Export data to CSV
  • Real-time value calculations

Sold Inventory

  • Complete sales history
  • Profit/loss tracking per item
  • Sort by date, type, or profit
  • Export sales data to CSV
  • Summary statistics
  • Combined silver & gold view

Adding Inventory Items

Adding new items to your inventory is simple. Here's what you need to know:

Adding Silver Items

  1. Navigate to the Silver Inventory page
  2. Click the "Add Silver" button
  3. Fill out the item details:
    • Description: Item name (e.g., "American Silver Eagles 2024")
    • Quantity: Number of units
    • Weight per Unit: Troy ounces per unit
    • Premium %: Premium over spot price
    • Purchase Price: Total amount paid
    • Acquisition Date: When acquired
  4. Click "Save" to add the item

Tip: If the item was a gift, enter "0.00" for Purchase Price.

Adding Gold Items

  1. Navigate to the Gold Inventory page
  2. Click the "Add Gold" button
  3. Fill out the item details:
    • Description: Item name (e.g., "1 oz Gold Buffalo")
    • Quantity: Number of units
    • Weight per Unit: Troy ounces per unit
    • Premium %: Premium over spot price
    • Purchase Price: Total amount paid
    • Acquisition Date: When acquired
  4. Click "Save" to add the item

Tip: If the item was a gift, enter "0.00" for Purchase Price.

Understanding Premiums & Purchase Prices

Premium Percentage

The premium is the amount above spot price you paid:

  • Generic rounds: typically 3-5%
  • Government coins (Eagles, Maples): 15-25%
  • Numismatic/collectible items: varies widely
Purchase Price

Enter the total amount paid including taxes, shipping, and fees. This is used to calculate your profit/loss accurately.

Incorrect purchase prices will result in inaccurate profit/loss calculations.

Selling Inventory Items

The sell feature allows you to record sales and track your realized profits or losses:

How to Sell an Item

  1. Go to your Silver or Gold Inventory page
  2. Find the item you want to sell
  3. Click the $ (sell) button in the Actions column
  4. Review the item details displayed
  5. Enter the sale information:
    • Sold Price: Total amount received
    • Sold Date: Date of sale
    • Notes: Optional sale details
  6. Click "Complete Sale"

The item will be moved from your active inventory to your sold inventory history.

Profit/Loss Calculations

The system automatically calculates your profit or loss:

Profit/Loss = Sold Price − Purchase Price

Examples:

  • Bought for $30, sold for $40 = +$10 profit
  • Bought for $2,000, sold for $1,800 = -$200 loss

Enter the actual amount received after any fees or commissions.

Using the Dashboard

The dashboard provides powerful visualization tools to track your portfolio:

Timeframe Selection

Use the dropdown to adjust the date range for all charts:

  • 2 weeks: Recent short-term trends
  • 1 month: Month-to-date performance
  • 6 months: Medium-term analysis
  • 1 year: Annual performance
  • All time: Complete history

Chart Types

Switch between three different visualizations:

  • Inventory Growth: Total ounces over time
  • Spot Price History: Silver & gold price trends
  • Portfolio Value: Total portfolio worth over time

Click on the tab names to switch views.

Privacy & Security

Anonymous Accounts

Create an account without providing personal information:

  • No email verification required
  • No personal details stored
  • Only your inventory data is saved

Important: Save your username and password! There is no recovery option for anonymous accounts.

Data Security

Your inventory data is protected:

  • All passwords are securely hashed
  • HTTPS encryption for all connections
  • No sharing of data with third parties
  • Regular security updates

Your metals inventory is only visible to you when logged in.

Frequently Asked Questions

How often are spot prices updated?
Spot prices are updated every 5 minutes during market hours. The timestamp of the last update is displayed on the dashboard.
Currently, the tracker only supports gold and silver. We plan to add support for platinum and palladium in a future update.
The profit/loss is calculated by comparing your total purchase price to the current value (spot price × premium factor × ounces).

Profit/Loss = (Spot Price × (1 + Premium/100) × Ounces) − Purchase Price
Yes! You can export your complete inventory as a CSV file from the Silver Inventory, Gold Inventory, and Sold Inventory pages. Look for the "Export CSV" button.
Currently, you can only sell the entire quantity at once. To sell a portion, first edit the item to split it into two separate entries, then sell one of them.
There's no direct undo function. If you make a mistake, you'll need to manually add the item back to your inventory with the same details as the original.
If you registered with an email, use the "Forgot Password" link on the login page. For anonymous accounts without an email, unfortunately there's no recovery option. We recommend using a password manager.

Need More Help?

If you have questions not covered in this documentation, we're here to help:

Email Support

[email protected]