API revenoo: valuta ogni particella svizzera dal suo EGRID

L’API revenoo valuta qualsiasi particella svizzera dal suo EGRID con gli stessi metodi dello strumento revenoo: affitti di mercato del comune, un DCF con tasso di sconto derivato, capitalizzazione diretta e tre valori residui del terreno, con sensibilità a due dimensioni. URL di base: https://revenoo.aireon.ch. Il contratto è OpenAPI 3.1 in /api/openapi.json.

Endpoint

Le cifre chiave

Valore DCF (totale e per m² NIA), tasso di sconto reale, valore per capitalizzazione, cap rate implicito, valore del terreno al rendimento sul costo obiettivo, valore del terreno con l’applicazione DCF e statica del metodo residuale con il TIR implicito, rendimenti netto e lordo, NOI dopo capex, reddito locativo potenziale, unità e valore DCF a ±30 pb. Con un prezzo richiesto per il terreno, la risposta aggiunge il TIR del progetto, il margine sul costo e sul valore e il rendimento iniziale sul costo.

Unità e fonti

L’unità è nella chiave: senza suffisso un importo (senza valuta), _pct in percento (2.95 significa 2,95%), _bp in punti base, _m2 in metri quadrati. Ogni parte indica metodo e fonti: RICS Discounted cash flow valuations (2023), RICS Valuation of development property (2019) e IVS 104.

Domande frequenti

Serve una chiave API?

No. L’API è pubblica e di sola lettura, non richiede chiave né accesso e accetta richieste da ogni origine (CORS). Le richieste non in cache sono limitate a 60 al minuto per client.

Come cambio le ipotesi?

Ogni risposta elenca le ipotesi usate. Invii in POST quelle da cambiare come {"assumptions": {...}} sullo stesso percorso, per esempio un prezzo richiesto per il terreno, un tasso di rendimento obiettivo, i costi di costruzione o il tasso di sconto. Chiavi sconosciute e valori fuori intervallo vengono respinti con 400 e un messaggio per problema.

Quanto è veloce?

La valutazione si calcola in meno di un millisecondo. La prima chiamata per un EGRID attende la ricerca della particella e del mercato, poi in cache per 6 ore; le risposte GET sono in cache nella CDN e la prima chiamata precarica le altre parti della stessa particella.

Possono usarla gli agenti IA?

Sì. aireon-mcp espone ogni operazione come strumento MCP chiamato revenoo_<operationId>, per esempio revenoo_getRevenooSummary.