Price context — GET /v1/products/{id}/context

Price context

Is this actually a good price? Percentile against the product's own history at that seller, time-weighted, with low, median and high.

GET /v1/products/{id}/context

Request

Name	Type	Notes
seller	string	Optional. Defaults to the cheapest current offer.
days	int	Window. Default 90.

Request & response

GET /v1/products/0885909950805/context?days=90

→ 200
{ "verdict": "excellent",          // excellent good typical poor flat
  "current": "$198.00", "seller": "bestbuy",
  "compared_against": "bestbuy",   // its OWN history, never pooled
  "percentile": 4.0, "covered_days": 89,
  "low": "$198.00", "median": "$319.99", "high": "$398.00",
  "last_seen_lower": null }

Notes

Percentiles are time-weighted. A price that held for sixty days counts sixty days, not one row — the naive version weights a one-day promotion the same as a quarter of stability.

Ties use midrank, so a listing that has never moved reads `flat` rather than “worst ever”.

Never pooled across sellers. Comparing the cheapest seller's price against everyone's history makes a genuine bargain look average.