---
title: "Sale + asking price statistics for a Mac configuration"
method: GET
path: "/api/v1/price-stats"
---

# Sale + asking price statistics for a Mac configuration

`GET /api/v1/price-stats`

## Request

- Base URL: `https://macfax.com`
- URL: `https://macfax.com/api/v1/price-stats`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in header `X-Api-Key`
  - API key in query parameter `api_key`

What a used Mac configuration actually sells for, and what sellers are asking right now. The sold block is the headline: verified-sale percentiles when the config has enough recent sales (sold.basis "direct"; n and window_days ride along), else the asking band scaled by a measured clearance ratio (sold.basis "calibrated", ratio_to_ask disclosed). The band is the live asking side — seller listing guidance: median/p25/p75 with sample size, per-channel medians with net-to-seller after fees, launch MSRP retention, Apple trade-in floor. Use the sold estimate as the price of the Mac; use asking to set a list price. The slices are never blended — preserve the basis label when you cite. Rate limits: 30/min and 1000/day per anonymous IP; 300/min and 10000/day with a free key.

## Query parameters

- `config` string, required

## Response `200`

Band + sold slice + channels + MSRP context (band may be null; sold.basis null = no honest sale estimate).

## Other responses

- `400`: Malformed config key.
- `429`: Rate limited.

---

[API](https://skmtc.dev/macfax/apis/macfax-api.md) · [All operations](https://skmtc.dev/macfax/apis/macfax-api/llms.txt) · [OpenAPI document](https://skmtc.dev/macfax/apis/macfax-api/revisions/ce892dbbd7d5?raw)