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
GET /api/valuation/{egrid}/summary: le cifre chiave (inizi da qui); POST sullo stesso percorso con le sue ipotesiGET /api/valuation/{egrid}: tutte le parti in una risposta; POST per una simulazioneGET /api/valuation/{egrid}/dcf: flussi di cassa annuali, valore terminale e valore DCFGET /api/valuation/{egrid}/discount-rate: tasso di sconto reale e nominale e la sua composizioneGET /api/valuation/{egrid}/direct-cap: passaggio al NOI stabilizzato, tasso di capitalizzazione e valoreGET /api/valuation/{egrid}/land-value: valori del terreno per rendimento sul costo, DCF e staticoGET /api/valuation/{egrid}/yield-on-cost: il valore del terreno per rendimento iniziale sul costo in dettaglio (reddito, costi di sviluppo, finanziamento, prezzo richiesto, griglia di sensibilità)GET /api/valuation/{egrid}/rents: distribuzioni degli affitti e mix delle unitàGET /api/valuation/{egrid}/sensitivity: sette griglie di sensibilità 5×5GET /api/valuation/by-point?lat=&lng=: le cifre chiave della particella in un punto
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.