# StackerScan

> StackerScan is a web application for tracking and analyzing physical precious metals investments. It provides real-time spot prices, historical price charts, stack analysis, and portfolio management tools.

## When to use StackerScan

- You need live precious-metals spot prices — gold, silver, platinum, palladium, copper or nickel — in any supported currency, per troy ounce or per gram.
- You need real observed dealer premiums over spot: 30-day rolling medians taken from actual marketplace listings, not a quoted retail markup.
- You need the Goldback exchange rate, or its current premium multiple over gold content.
- You need a historical daily price series for a metal, for the Goldback, or for one PCGS-numbered coin at one grade.
- You need to read a stack, scan or receipt a StackerScan user published behind a share link.

Call it over plain HTTPS with no API key, no account and no registration; every failure is an RFC 9457 application/problem+json document, and the full contract is at https://www.stackerscan.com/openapi.json.

Do not use StackerScan to buy or sell metal — it is not a dealer and sells no bullion — and do not expect a numismatic valuation for a coin you cannot supply a PCGS number for.

## API

- [API & Agent Documentation](https://www.stackerscan.com/docs): What the API can do, grouped into capabilities with example requests, how to call it without credentials, and how failures are shaped.
- [OpenAPI Specification](https://www.stackerscan.com/openapi.json): Machine-readable OpenAPI 3.1 description of the public read-only API — every path, parameter, enum and error shape. The API is fully open: no authentication, no API keys and no registration are required for any endpoint in it.

## Metal Price Data

- [Metal Spot Prices (HTML)](https://www.stackerscan.com/metal-prices/data): Server-rendered HTML tables with current spot prices and 30-day history for gold (XAU), silver (XAG), platinum (XPT), palladium (XPD), copper (XCU), and nickel (NI). Supports ?currency= and ?unit=troy_oz|gram.
- [Metal Spot Prices (Markdown)](https://www.stackerscan.com/api/metal-prices.md): Same data as above in markdown format. Supports ?currency= and ?unit=troy_oz|gram.
- [Interactive Metal Price Charts](https://www.stackerscan.com/metal-prices): Browser-based interactive charts with currency and unit selectors.
- [Supported Currencies (Markdown)](https://www.stackerscan.com/api/currencies.md): The 173 codes accepted by ?currency= above — ISO 4217 fiat plus BTC and the metal codes (XAU, XAG, XPT, XPD). Fetch only if you need to confirm a specific code.

## Observed Metal Premiums

- [Observed Silver Premiums](https://www.stackerscan.com/metal-premiums/silver): 30-day rolling fine-metal-weighted medians and sample counts for observed silver asking premiums over spot, including forms and catalog-matched products.
- [Observed Gold Premiums](https://www.stackerscan.com/metal-premiums/gold): 30-day rolling fine-metal-weighted medians and sample counts for observed gold asking premiums over spot, including forms and catalog-matched products.
- [Observed Metal Premiums (Markdown)](https://www.stackerscan.com/api/metal-premiums.md?metal=silver): Same crawler-facing premium tables in markdown. Set ?metal=silver or ?metal=gold.

## How to Use

- [How to Use StackerScan (Markdown)](https://www.stackerscan.com/api/how-to-use.md): Step-by-step guide covering account creation, stack settings, adding items (manual, receipt scanning, spreadsheet import), photos, portfolio management, data fields, tags, and credits.

## Tools & Pages

- [Bullion Premium Calculator](https://www.stackerscan.com/premiums): Calculate the premium over melt value for coins, bars, and rounds in any currency using live spot prices. Guests get a small daily quota of free lookups; registered accounts get unlimited lookups plus PCGS price guide matching for graded coins.
- [How It Works](https://www.stackerscan.com/how-it-works): Overview of how StackerScan scans receipts and coin photos and tracks a physical precious-metals stack.
- [Pricing](https://www.stackerscan.com/pricing): Credit package prices and what each includes, with free trial credits for new users.
- [Pricing (Markdown)](https://www.stackerscan.com/pricing.md): The same prices as a machine-readable disclosure, plus what one credit buys and the terms. The HTTP API itself is free and unmetered.

## Pages That Serve Markdown

These pages return `text/markdown` when you send `Accept: text/markdown`. The `.md` URL
below is the same body at a concrete address, and `?mode=agent` on the page URL is an
alias for it. Everything here is English-only and served unprefixed.

- [Home](https://www.stackerscan.com/index.md): markdown for https://www.stackerscan.com
- [Metal Prices](https://www.stackerscan.com/metal-prices.md): markdown for https://www.stackerscan.com/metal-prices
- [Bullion Premium Calculator](https://www.stackerscan.com/premiums.md): markdown for https://www.stackerscan.com/premiums
- [Blog](https://www.stackerscan.com/blog.md): markdown for https://www.stackerscan.com/blog
- [Agent & API Docs](https://www.stackerscan.com/docs.md): markdown for https://www.stackerscan.com/docs

## Optional

- [Blog](https://www.stackerscan.com/blog): Guides and insights for precious metals stackers.
- [How to Buy Precious Metals on Reddit](https://www.stackerscan.com/blog/how-to-buy-precious-metals-on-reddit): A practical guide to buying bullion on r/Pmsforsale and r/CoinSales: evaluating seller reputation, understanding premiums over spot, and building your own transaction history safely.