Skip to content

price-collection

Get pricing for your card collection. Alias: pc.

Terminal window
./ritual price-collection [collectionName] [options]
ArgumentDescriptionRequired
[collectionName]Name of a single collection file (without extension)No

When no collection name is given, all .md files in the collections/ directory are priced and a grand total is shown. A given name is matched case-insensitively, with a unique-substring fallback; an ambiguous name is rejected. See List Resolution.

OptionDescription
--sort <field>Sort cards by name or price (default: listed order)
--descendingReverse the sort direction
--prices <currency>Price currency: usd, eur, or tix (default: usd)
--output <format>Output format (json or text)
--quietSuppress non-essential output

Price all collections:

Terminal window
./ritual price-collection

Sort by price, most expensive first:

Terminal window
./ritual pc --sort price --descending

Price a single collection:

Terminal window
./ritual pc "Red Binder"

Machine-readable JSON output:

Terminal window
./ritual pc --output json

Show EUR (Cardmarket) prices:

Terminal window
./ritual pc --prices eur

For each collection the command displays the total price based on exact printings.

Each card is priced using its specific set and collector number. The finish determines which price is used (usd, usd_foil, or usd_etched for USD; eur or eur_foil for EUR; tix for MTGO). Cards without a finish default to nonfoil.

Cards missing a set code and collector number are skipped with a warning.

Prices are fetched from Scryfall’s price data. Use --prices eur for Cardmarket EUR prices or --prices tix for MTGO ticket prices.

Cards that are not available in the selected currency’s game format (e.g., a paper-only card when pricing in TIX) are skipped with a warning and omitted from totals.