Parchment Price Index

Price index commands

Parchment Price Index snapshots, matched 30-day price comparisons, and chart history.

Read Parchment Price Index snapshots, matched 30-day price comparisons, and chart history for origins and processes.

Access: Varies by command.

purvey price-index

Fetch Parchment Price Index aggregate snapshots.

Usage: purvey price-index [options]

Access: Member. Requires member access on your account.

Requires a scoped member API key with Parchment Price Index access.
PARCHMENT_API_KEY or PURVEYORS_API_KEY overrides the scoped API key stored by purvey auth login.
--from and --to accept ISO dates (YYYY-MM-DD); --wholesale accepts "true" or "false".

Argument or flag	Details
`--origin <origin>`	Only this origin (case-insensitive exact name).
`--process <method>`	Only this process (case-insensitive exact name), such as washed.
`--grade <grade>`	Only this grade (case-insensitive exact name).
`--from <date>`	Only snapshots on or after this date, as YYYY-MM-DD.
`--to <date>`	Only snapshots on or before this date, as YYYY-MM-DD.
`--wholesale <true\|false>`	true for wholesale prices only, false for retail only; without it, both.
`--page <n>`	Page number, starting at 1. Default: 1.
`--limit <n>`	Number of snapshots per page. Default: 100. Range: 1 to 100.

Examples

purvey price-index --pretty
purvey price-index --origin "Ethiopia" --json
purvey price-index --from 2026-01-01 --to 2026-06-30 --pretty

Available exact 30-day matched price comparisons with significance.

Usage: purvey price-index comparisons [options]

Access: Member. Requires member access on your account.

Requires Parchment Intelligence access.
Lists every origin with an exact 30-day matched comparison; an empty comparisons list means none qualify.
Each comparison carries significance unchanged; classification (quiet|normal|notable|exceptional) is null until eight baseline windows exist, meaning not enough history, never quiet.

Argument or flag	Details
`--wholesale <true\|false\|all>`	true for wholesale listings, false for retail, or all for both. Default: false.

Examples

purvey price-index comparisons --pretty
purvey price-index comparisons --wholesale all --json

Matched-listing price comparison for one origin between two exact dates.

Usage: purvey price-index comparison [options]

Access: Member. Requires member access on your account.

Argument or flag	Details
`--origin <origin>`	Required. Origin to compare.
`--from <date>`	Required. Starting date, as YYYY-MM-DD (UTC).
`--to <date>`	Required. Ending date, as YYYY-MM-DD (UTC), within 365 days of --from.
`--wholesale <true\|false>`	true to compare wholesale listings, false for retail. Default: false.

Examples

purvey price-index comparison --origin "Ethiopia" --from 2026-08-31 --to 2026-09-30 --pretty

Daily price-index history for charts; windows up to 90 days are public.

Usage: purvey price-index history [options]

Access: None. Works without signing in.

Windows up to 90 days (the default) run without credentials; 91-365 days require Parchment Intelligence access.

Argument or flag	Details
`--window-days <n>`	Number of past days to include; up to 90 works without signing in, longer windows need Parchment Intelligence. Default: 90. Range: 1 to 365.
`--page <n>`	Page number, starting at 1. Default: 1.
`--limit <n>`	Number of data points per page. Default: 100. Range: 1 to 10000.
`--order <asc\|desc>`	Date order: asc (oldest first) or desc (newest first). Default: asc.

Examples

purvey price-index history --pretty
purvey price-index history --window-days 365 --limit 500 --json