Market Index
Market commands
Market Index value signals, movement stats, metadata trends, overview, and evidence.
Check market value signals, price movement, metadata trends, and the evidence behind them. Summary views are open to everyone; filtered views require Parchment Intelligence access.
Access: Varies by command.
purvey market signals
Actionable market value signals; unfiltered summary is a public teaser.
Usage: purvey market signals [options]
Access: None. Works without signing in.
- --summary is the only unauthenticated slice (counts only); any filter requires Parchment Intelligence access.
| Argument or flag | Details |
|---|---|
--summary | |
--type <type> | repeatable or comma-separated: price_drop|below_market|value_quality. |
--origin <origin> | |
--process <method> | |
--market <retail|wholesale|all> | |
--min-discount <n> | |
--min-score <n> | |
--window <7d|30d> | |
--limit <n> | Results per page, 1-100. Range: 1 to 100. |
purvey market signals --summary --pretty
purvey market signals --type price_drop --type below_market --origin "Ethiopia" --jsonpurvey market stats
Price movement-significance stats; unfiltered retail slice is public.
Usage: purvey market stats [options]
Access: None. Works without signing in.
- The no-origin/no-process retail slice is public; origin/process/wholesale filters require Intelligence access.
| Flags |
|---|
--origin <origin> |
--process <method> |
--market <retail|wholesale|all> |
--window <7d|30d> |
--baseline-weeks <n> |
purvey market stats --pretty
purvey market stats --origin "Colombia" --window 30d --jsonpurvey market metadata
Metadata-trend index; process/retail/month slice is public.
Usage: purvey market metadata [options]
Access: None. Works without signing in.
- Public slice: dimension=process, no origin, market=retail, grain=month; anything else requires Intelligence access.
- Cultivar and drying dimensions are not available yet.
| Flags |
|---|
--dimension <process|disclosure|score> |
--origin <origin> |
--market <retail|wholesale|all> |
--grain <week|month> |
--from <date> |
--to <date> |
purvey market metadata --pretty
purvey market metadata --dimension score --origin "Ethiopia" --grain month --jsonpurvey market overview
Aggregate-only green-coffee market overview over the public catalog.
Usage: purvey market overview
Access: Viewer. Any signed-in account.
- The API rejects anonymous requests; any signed-in session or API key with catalog read access receives the same public evidence.
- Emits the API response verbatim: daily change, coverage, movement, process distribution, and origin price distributions.
purvey market overview --prettypurvey market evidence
Named arrivals, delistings, comparable lots, and supplier health and price ranges.
Usage: purvey market evidence
Access: Member. Requires member access on your account.
- Requires Parchment Intelligence plus catalog read access.
purvey market evidence --json