Find Discounted Real-Estate Auctions
find_distressed_auctionsFind discounted Spanish judicial and notarial property auctions ranked by debt-to-value ratio and equity margin, with Catastro valuation data and province/LTV filters.
Instructions
Screen official Spanish judicial and notarial real-estate auctions enriched with Catastro valuation data, ranked ascending by debt-to-value ratio (ltv_pct) and equity margin. Costs $0.10 USDC or EURC per call via DATAX_TOKEN (returns HTTP 402 if unset). Returns masked auction previews and opaque item_ref handles ('dx_...') unlockable via get_tender_detail ($0.50). Use this specifically to discover discounted Spanish property auctions; use search_tenders for non-auction records.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "find_distressed_auctions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of ranked auctions to return (1 to 25, default 10). | |
| ambito | No | Case-insensitive province or region substring filter (e.g. 'Madrid' or 'Valencia'). Leave empty to search all regions. | |
| max_ltv_pct | No | Maximum claimed debt as a percentage of appraisal value (1 to 1000, default 100). Lower percentages indicate deeper discounts. | |
| min_value_eur | No | Minimum official appraisal or auction value in EUR (>= 0, default 0). | |
| concursal_only | No | When true, restrict results to bankruptcy/insolvency court auctions (SUB-JC-*). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No | ||
| status | No | ||
| change_token | No |