search_auction_history
ActiveTool of Provenio — Art Intelligence
declared in 0.3.2-measured
Cost: ~0.7s. Auction transaction rows with optional percentile_summary=true to also return P25/50/75/90 + realized-vs-estimate in ONE call. Use when: need lot-level prices OR percentile stats. Do NOT use if: you only need per-artist aggregates — use query_market_summary. SINGLE-CALL FRIENDLY — combine filters + percentile_summary for appraisal work.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 200,
"minimum": 1,
"description": "Max rows. Default 10."
},
"date_to": {
"type": "string",
"description": "ISO date or year for upper bound."
},
"date_from": {
"type": "string",
"description": "ISO date or year, e.g. '1990' or '1990-05-01'."
},
"artwork_id": {
"type": "string",
"description": "Filter by specific artwork ID slug or full 'artwork:...'."
},
"artist_name": {
"type": "string",
"description": "Artist name substring, e.g. 'Basquiat', 'Gauguin'. Case-insensitive."
},
"min_price_usd": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Minimum price in USD. Uses price_usd_2024_cpi when available, else nominal USD. 1e6 = 1 million."
},
"medium_keyword": {
"type": "string",
"description": "Substring match against artwork medium (joins via artwork_id). E.g. 'oil', 'bronze', 'watercolor', 'print'."
},
"percentile_summary": {
"type": "boolean",
"description": "If true, also return P25/P50/P75/P90 percentiles and avg realized/estimate ratio over the filtered set. Use for appraisal / comp-set analysis."
}
}
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
Provenio — Art Intelligence
https://github.com/mildo-ai/brain_for_art
1/7 registries