Search the WatchCharts market screener (top performers).

Returns structured rows: name, collection, watch_id, url, image, market_price (EUR string), price_trend_pct over period.

Count watches matching the screener filters.

List all watch brands with their WatchCharts brand ids.

Search watch models by text (site autocomplete).

Best way to resolve a reference to a watch_id. Returns models with watch_id (id), uuid, brand, brand_id, collection, reference, current price, image.

Full specs and key figures for a watch model: references, complications, case/dial details, market price, retail price.

Auction sale records for a watch model (Sotheby's, Christie's...): hammer price, date, auction house, lot URL.

Historical marketplace listings (sold and unsold) for a watch model, newest first: price, date, source (eBay, dealers, forums), URL.

Market index time series (overall or per brand), from 2017 to today.

Values are index points in EUR. Much deeper history than per-watch price charts.

Browse the full 29k+ watch catalog with spec filters.

Returns watch_id, name, collection, production status, key attributes, retail + market price, URL, image.

Historical market price series for a watch model.

Returns daily prices (date, price) plus retail price and model info. Free tier covers roughly the last year of data. Pass variation_id for the series of a single reference/dial.

Live eBay listings for a watch, as aggregated by WatchCharts marketplace.

Returns title, seller, price (site currency), listing URL, image.

Search/browse WatchCharts Marketplace listings (dealers, Reddit, forums, eBay).

Returns listing_id, title, price, price_rating (Fair/Good/High Price), country, external URL, image. Use get_listing for full details.

Details for one marketplace listing: price, value assessment vs WatchCharts estimate, source site, posting date, external URL.

Instant appraisal — estimated market value for a watch given its condition, delivery contents, and region.

This is the equivalent of the paid API's appraisal. It drives the real appraisal form (the submit is captcha-protected and can't be called directly), so it takes ~10-15s. Returns the estimated value plus the condition/accessory/region actually matched.

Evaluate whether an asking price is a good deal for a watch.

Gathers, in one call, the appraisal estimate, current market price, recent price trend (90d / 1y), and comparable listings — plus the computed gap between the asking price and the reference value, and where the asking price sits among comparable listings. Use these figures to give the user a buy / negotiate / pass recommendation with reasoning: a negative vs_reference_pct and a low asking_price_percentile mean the price is attractive; weigh it against the trend direction.