Benchmark an auction against similar ones
find_comparable_auctionsFinds comparable completed auctions for a reference lot, reporting median prices and sell rates to benchmark a bid or assess market risk.
Instructions
Takes one auction and finds recent comparable ones, then reports median prices and how often that kind of lot actually sells.
WHEN TO USE: valuation and risk questions — "is this price reasonable", "what do similar plots go for", "how likely is this to sell", "should I bid at the starting price".
KEY PARAMETERS
auction (required): the reference auction — public auction id or procedure id.
match_on: what a comparable must share. Default ["sellingMethod","classification"]. sellingMethod — same auction format and programme classification — same CAV asset category region — same oblast; add this for a local benchmark, which is usually what is wanted valueRange — within ±50% of the starting price; use to exclude outliers Adding more criteria gives a tighter but smaller sample.
concluded_only: default true — compares only against finished auctions, which is what a price benchmark needs. Set false to also see what is currently on the market.
limit / scan_pages: widen the sample when comparableCount comes back low.
EXAMPLE — price benchmark for a land lease: {"auction":"LRE001-UA-20260708-03894","match_on":["sellingMethod","classification"]}
EXAMPLE — what similar assets are on the market right now: {"auction":"SPD001-UA-20260806-70620","concluded_only":false,"limit":25}
RETURNS: the reference summary, median starting and achieved prices, sold share, and the comparable auctions themselves. Re-listings of the same lot are excluded so one asset is not counted twice. The sample comes from recent activity, not full history — say so when quoting a figure.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum comparables to return. Default 15. | |
| auction | Yes | Reference auction — public auction id (e.g. "LRE001-UA-20260708-03894") or 24-character procedure id. | |
| match_on | No | Which attributes a comparable must share. Default ["sellingMethod", "classification"]. Add "region" for local benchmarks, "valueRange" to stay within ±50% of the starting price. | |
| scan_pages | No | Feed pages to scan when a broad search is needed. Default 8. | |
| concluded_only | No | Only compare against auctions that already finished (complete or unsuccessful), which is what a price benchmark needs. Default true. |