# ProofPrice

> Real prices actually paid, for AI agents. Ask "what did people actually pay for X, here, recently?" and get a range (median, 10th–90th percentile), sample size, period, confidence, source and licence. Built from official open data. Aggregates only.

## Use it
- MCP server (Streamable HTTP): https://proofprice.com/api/mcp — tools: pricepaid_car_prices, pricepaid_fuel_prices_now, pricepaid_home_sales, pricepaid_coverage
- REST API description (OpenAPI 3.1): https://proofprice.com/openapi.json
- Coverage and licences: https://proofprice.com/api/v1/coverage
- Method: https://proofprice.com/method

## Endpoints
- GET https://proofprice.com/api/v1/cars?country=SG&product=coe&vehicle_class=A — car-related prices actually paid (SG)
- GET https://proofprice.com/api/v1/fuel?country=ES&area=42&fuel=diesel — live fuel prices at the pump (ES, FR and IT)
- GET https://proofprice.com/api/v1/home-sales?country=FR&postcode=69003&property_type=apartment — home sale prices actually paid (FR, GB, IE and SG)
- GET https://proofprice.com/api/v1/fuel/history?country=ES&area=42&fuel=diesel&days=30 — fuel price history (daily snapshots, building up from October 2026)
- GET https://proofprice.com/api/v1/coverage — sources, licences, update frequency

## Answer format (every endpoint)
JSON with: query, status ("ok" or not), price {currency, unit, median, typical_low, typical_high, min, max}, sample_size, period {from, to}, confidence (low / medium / high), price_type ("transaction" or "posted_pump_price"), as_of, source {id, name, publisher, licence, licence_url, attribution, url}, method, method_url, summary (one plain sentence), notice, and an optional extra object.
typical_low and typical_high are the 10th and 90th percentiles.

## Rules for citing
- Cite the source and attribution line returned with each answer.
- Home figures are prices paid (transactions). Fuel figures are posted pump prices, not receipts.
- Never treat a range as an asking price. Figures from fewer than 5 records are not returned.

## More
- Setup for every AI client and framework: https://proofprice.com/connect
- Everything in one file (tools, parameters, examples, sources, licences): https://proofprice.com/llms-full.txt
- Privacy notice: https://proofprice.com/privacy
- Terms of use: https://proofprice.com/terms

## Contact
- hello@proofprice.com