# Market commands

> Market Index value signals, movement stats, metadata trends, overview, and evidence.

HTML version: https://www.purveyors.io/docs/cli/market

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

Examples:

```bash
purvey market signals --summary --pretty
purvey market signals --type price_drop --type below_market --origin "Ethiopia" --json
```

## purvey 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>` |

Examples:

```bash
purvey market stats --pretty
purvey market stats --origin "Colombia" --window 30d --json
```

## purvey 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>` |

Examples:

```bash
purvey market metadata --pretty
purvey market metadata --dimension score --origin "Ethiopia" --grain month --json
```

## purvey 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.

Examples:

```bash
purvey market overview --pretty
```

## purvey 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.

Examples:

```bash
purvey market evidence --json
```

## Related

- [Market Index](https://www.purveyors.io/analytics): The same market data as charts in the web app.
- [Price index commands](https://www.purveyors.io/docs/cli/price-index): Aggregate price snapshots and matched comparisons.
- [CLI overview](https://www.purveyors.io/docs/cli/overview): Install, sign in, and see every command group.