AssassinCreator/steam-stash-value-report-cardPublic

$ stashcard
  paste a profile  ->  pick a card  ->  get a PNG worth posting

Stashcard values a Steam account and its inventories (CS2, Dota 2, TF2, Rust, Steam community items or any custom app) from your terminal, prices them on Steam and on the big cash marketplaces, and prints the result as a shareable card: a report card, a game card, an inventory picture, a thermal receipt, a marketplace comparison, or a then-vs-now / A-vs-B diff.

Every number carries its venue and window. LOWEST is the floor listing right now. AVG is the mean of real sales over a window you pick. Steam money is wallet funds; everything else is cash, and the two are never mixed silently. When a source has nothing, Stashcard falls back and says so on the row, in the totals and in the card footer. Nothing unpriced is ever counted as zero.

Free and open source. No accounts, no paid APIs, no telemetry.

Download and start the exe. No installer, no admin rights.

The build is not code-signed yet, so SmartScreen may warn once: choose More info, then Run anyway.

Real cards from the bundled demo (a fictional profile with real item names, icons and a dated price snapshot).

Report card, midnight	Report card, paper
Marketplaces	Receipt
Game card, CS2	Game card, Dota 2, paper
Inventory picture	Then vs now, phosphor
A vs B, light redaction	Full redaction, phosphor

Every PNG ships with a card.json sidecar (enough to re-render it offline and check the numbers) and a card.alt.txt with alt text you can paste wherever you post the image.

pipx install git+https://github.com/AssassinCreator/steam-account-value-checker.git

Or from a clone:

git clone https://github.com/AssassinCreator/steam-account-value-checker.git
cd stashcard
pipx install .            # or: python -m venv .venv && .venv/bin/pip install -e ".[dev]"

Python 3.11 or newer. Dependencies: httpx, brotli, rich, questionary, Pillow, platformdirs. Inter and JetBrains Mono are bundled (SIL Open Font License). Windows steps are below.

Use your home PC. Windows is recommended; home Linux and macOS work fine too.

Steam throttles inventory and market requests per IP, and datacenter, VPS and cloud ranges are throttled much harder than home connections. In our tests a Linux server in a datacenter got HTTP 429 on its very first inventory request, so live scans there are unreliable. On a server, only the offline demo and data you already cached work reliably. Stashcard does not bundle proxies or any other workaround, and it tells you plainly when Steam says no.

1. Install Python 3.12 from python.org (tick Add python.exe to PATH), or run winget install Python.Python.3.12.

2. In PowerShell:

   py -m pip install --user pipx
   py -m pipx ensurepath
   # open a new terminal, then:
   pipx install git+https://github.com/AssassinCreator/steam-account-value-checker.git
   stashcard demo

3. Use Windows Terminal (the default terminal on Windows 11). It shows colours, the arrow-key menus and the half-block card preview. The classic console still works; Stashcard then prints the path to the PNG instead of a preview, and --open opens the card in your image viewer. Windows Terminal 1.22+ can also show sixel images: set STASHCARD_PREVIEW=sixel (TODO(verify): not tested on real hardware yet).

Settings, cache and history go to %LOCALAPPDATA%\stashcard (stashcard config path prints the exact folders). The CI runs the test suite and the demo on Windows as well as Linux.

stashcard                                   # interactive: paste a profile, arrow keys for the rest
stashcard demo                              # offline demo, writes stashcard-demo-summary.png
stashcard demo --mode all --out-dir cards   # every layout at once

stashcard card https://steamcommunity.com/id/yourname --mode grid --game cs2 -c EUR -o stash.png
stashcard markets yourname -c EUR           # every venue's floor, net after fees, where to sell
stashcard value 76561197960287930 --lowest-from best --json valuation.json --csv items.csv
stashcard diff yourname@last yourname       # then vs now, from local history
stashcard diff yourname theirname           # A vs B, redacted by default
stashcard render stash.json --theme paper   # re-render a sidecar offline

Profiles can be pasted in any form: steamcommunity.com/id/<name>, /profiles/<steamid64>, a bare SteamID64, STEAM_0:X:Y, [U:1:N], a numeric friend code, s.team/p/<code> invite links, or just the custom URL name.

Utilities: history P, config show | me | api-key | cookie | forget-secrets | reset | path, cache info | clear, currencies.

The interactive flow asks for the same things with arrow keys (including a multi-select for marketplaces) and remembers your last choices.

Two numbers, never mixed up.

Steam's public API only exposes a 24 hour median without a login, so for Steam community items (appid 753), which no cash venue covers, AVG falls back to Steam median · 24h. The card says exactly that, and so does every table row (*) and the footer (+7 Steam median · 24h).

All free, no keys, verified live on 2026-10-29. Whole-catalog feeds are fetched once per game, cached for an hour and looked up locally. Stashcard sends an honest User-Agent and paces every host.

Seller fees are defaults from fee pages and review sites as of 2026-10-29. Venues change and tier them, so they are marked TODO(verify) in markets.py; override them with --fee.

Wallet vs cash. Steam money can only be spent on Steam. The cards, tables and exports keep a WALLET or CASH tag on every venue. The best cash route adds up each stack sold at its best cash venue after fees; Steam's net is shown next to it, never summed into it. Venue totals cover only what that venue lists, so each comes with its coverage of your value.

Outlier guard. AVG stays the mean, as promised, but the window median and max ride along. An item is badged skewed when the mean and median differ by more than 25 % or the max sale is above 5x the median. A real example: AK-47 | Redline (FT) once showed a 30 day mean of $39.85 against a median of $26.65 because of a single $2,114 sale. The median sits next to AVG in tables and on cards, skewed items are counted in the totals, and --trimmed-avg drops the extremes (labelled trimmed avg).

Fees and the two kinds of net.

• Net on Steam (wallet): what you would receive listing at the Steam floor, after the 5 % Steam fee and the 10 % game fee, using Valve's exact rounding (ported from the market's own economy_common.js and tested so seller_receives(buyer_pays(x)) == x for every amount up to $200).
• Net at a cash venue: that venue's floor x (1 - seller fee).

Honesty checks run on every scan and show up in the terminal, on the cards and in the sidecar:

Rate limits. Steam rate-limits inventories hard (see Where to run it). Stashcard caches inventories for 10 minutes, Steam prices for 3 hours and venue catalogs for an hour, paces requests per host, backs off with jitter, honours Retry-After, and asks Steam about the most valuable items first so a 429 hurts least. When blocked it uses stale cache (and says how old) or tells you plainly: Steam is rate-limiting this connection; retry in N min, use cached data, or try the demo.

• Local only. Settings, cache and scan history live in your user folders (stashcard config path). Nothing is uploaded anywhere. No telemetry, no analytics, no accounts.
• Redaction presets. --redact light masks the name (K•••••l) and SteamID64 (last 4 digits), blurs the avatar and drops the profile link and location. --redact full also replaces the avatar, shows "Anonymous collector" and turns totals into value bands ($2.5k–5k). By default your own profile (stashcard config me <profile>) is unredacted, anyone else's is full, and until you set "me" the default is light. A-vs-B cards are at least light on both sides. Demo profiles are fictional.
• Clean files. PNGs are written without text chunks or metadata. Sidecars respect the same redaction (value bands hide totals on the image; item rows stay in card.json so others can verify it, so skip it with --no-sidecar if you need the totals hidden).
• Secrets. The optional API key and cookie are stored in secrets.json with mode 0600, or read from STASHCARD_STEAM_API_KEY / STASHCARD_STEAM_LOGIN_SECURE. They are never printed in full (set (…a1b2)), never written to cache keys or sidecars, and the cookie is only sent to steamcommunity.com. The cookie is a full Steam session: only add it if you understand that, and remove it with stashcard config cookie.

Rarity is always shown as text next to its colour, and WALLET/CASH as text next to theirs. --plain and NO_COLOR give colourless ASCII output. Every card gets alt text. Theme text colours are checked for contrast in the test suite.

• stashcard watch --once with exit codes for cron, plus an optional self-hosted ntfy webhook.
• "Household" roll-up cards across several profiles.
• Instant-sell value from Steam buy orders for the top items, next to LOWEST and AVG.
• A source cross-check that flags venues far from the consensus floor.
• "Premium possible" flags from inventory data only: StatTrak, applied stickers, name tags, Doppler phases ("priced at the base name; real value may be higher").
• Library value at current store prices (with a Web API key), shown as replacement cost, never summed into a sale value.
• history sparklines in the terminal and a value-over-time card.
• Animated WebP cards for socials.

python scripts/make_assets.py            # PNG cards, banner, terminal.svg
pip install -e ".[gifs]"                 # pyte + pexpect, dev-only
python scripts/make_gifs.py              # assets/demo.gif (real pty recording) and assets/cards.gif

Stashcard is not affiliated with, endorsed by or sponsored by Valve Corporation or Steam, or by any of the marketplaces it reads. Steam, the Steam logo, Counter-Strike, Dota and Team Fortress are trademarks of Valve Corporation. Item names and images belong to their owners. Prices are informational estimates from public market data, not offers, appraisals or financial advice, and can be stale or wrong. Steam accounts cannot be sold under the Steam Subscriber Agreement; nothing here is an "account value".

MIT, see LICENSE. Bundled fonts: Inter and JetBrains Mono, SIL Open Font License 1.1 (src/stashcard/fonts/*.txt).