price-collection
Get pricing for your card collection. Alias: pc.
Usage
./ritual price-collection [collectionName] [options]
Arguments
| Argument | Description | Required |
|---|---|---|
[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.
Options
| Option | Description |
|---|---|
--sort <field> | Sort cards by name or price (default: listed order) |
--descending | Reverse the sort direction |
--prices <currency> | Price currency: usd, eur, or tix (default: usd) |
--output <format> | Output format (json or text) |
--quiet | Suppress non-essential output |
Examples
Price all collections:
./ritual price-collection
Sort by price, most expensive first:
./ritual pc --sort price --descending
Price a single collection:
./ritual pc "Red Binder"
Machine-readable JSON output:
./ritual pc --output json
Show EUR (Cardmarket) prices:
./ritual pc --prices eur
Output
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.
Prices reflect Near Mint (NM) market values. Card condition (LP, MP, HP, DMG) can significantly decrease actual value.