Parchment Price Index

Price index commands

Parchment Price Index snapshots, matched 30-day 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 price-index (PPI) access; the API enforces the entitlement.
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".

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.
The API discovers origins with an exact 30-day matched comparison; an empty comparisons list means none qualify.
Each comparison carries significance verbatim; classification (quiet|normal|notable|exceptional) is null until eight baseline windows exist, meaning not enough history, never quiet.

Flags
`--wholesale <true\|false\|all>`

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.
`--from <date>`	required; ISO date YYYY-MM-DD.
`--to <date>`	required; ISO date within 365 days of --from.
`--wholesale <true\|false>`

Examples

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

Tier-one price-index chart history; 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>`	Trailing window in days, 1-365. Range: 1 to 365.
`--page <n>`
`--limit <n>`	Results per page, 1-10000. Range: 1 to 10000.
`--order <asc\|desc>`

Examples

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