# Price index commands

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

HTML version: https://www.purveyors.io/docs/cli/price-index

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".

| Argument or flag | Details |
| --- | --- |
| `--origin <origin>` |  |
| `--process <method>` |  |
| `--grade <grade>` |  |
| `--from <date>` |  |
| `--to <date>` |  |
| `--wholesale <true\|false>` |  |
| `--page <n>` |  |
| `--limit <n>` | Results per page, 1-100. Range: 1 to 100. |

Examples:

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

## purvey price-index comparisons

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:

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

## purvey price-index comparison

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.

- Requires Parchment Intelligence access.
- status insufficient_fresh_coverage returns a null changePercent, never zero.

| 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:

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

## purvey price-index history

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:

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

## Related

- [Market commands](https://www.purveyors.io/docs/cli/market): Value signals and movement statistics.
- [CLI overview](https://www.purveyors.io/docs/cli/overview): Install, sign in, and see every command group.