API revenoo : évaluer toute parcelle suisse par son EGRID
L’API revenoo évalue toute parcelle suisse à partir de son EGRID avec les mêmes méthodes que l’outil revenoo : loyers de marché de la commune, DCF avec taux d’actualisation construit, capitalisation directe et trois valeurs résiduelles du terrain, avec des sensibilités à deux dimensions. URL de base : https://revenoo.aireon.ch. Le contrat est OpenAPI 3.1 sous /api/openapi.json.
Endpoints
GET /api/valuation/{egrid}/summary: les chiffres clés (commencer ici) ; POST sur le même chemin avec vos hypothèsesGET /api/valuation/{egrid}: toutes les parties en une réponse ; POST pour une simulationGET /api/valuation/{egrid}/dcf: cash-flows annuels, valeur terminale et valeur DCFGET /api/valuation/{egrid}/discount-rate: taux d’actualisation réel et nominal, et sa constructionGET /api/valuation/{egrid}/direct-cap: passage au NOI stabilisé, taux de capitalisation et valeurGET /api/valuation/{egrid}/land-value: valeurs du terrain par rendement sur coût, DCF et statiqueGET /api/valuation/{egrid}/yield-on-cost: la valeur du terrain par rendement initial sur coût en détail (revenu, coûts de développement, financement, prix demandé, grille de sensibilité)GET /api/valuation/{egrid}/rents: distributions des loyers et mix des logementsGET /api/valuation/{egrid}/sensitivity: sept grilles de sensibilité 5×5GET /api/valuation/by-point?lat=&lng=: les chiffres clés de la parcelle en un point
Les chiffres clés
Valeur DCF (totale et par m² NIA), taux d’actualisation réel, valeur de capitalisation, taux de capitalisation implicite, valeur du terrain au rendement sur coût cible, valeur du terrain par l’application DCF et statique de la méthode résiduelle avec son TRI implicite, rendements net et brut, NOI après capex, état locatif théorique, logements et valeur DCF à ±30 pb. Avec un prix demandé pour le terrain, la réponse ajoute le TRI du projet, la marge sur coût et sur valeur et le rendement initial sur coût.
Unités et sources
L’unité figure dans la clé : sans suffixe un montant (sans devise), _pct en pour cent (2.95 signifie 2,95 %), _bp en points de base, _m2 en mètres carrés. Chaque partie indique sa méthode et ses sources : RICS Discounted cash flow valuations (2023), RICS Valuation of development property (2019) et IVS 104.
Questions fréquentes
Faut-il une clé d’API ?
Non. L’API est publique et en lecture seule, ne demande ni clé ni connexion et accepte les requêtes de toutes les origines (CORS). Les requêtes non mises en cache sont limitées à 60 par minute et par client.
Comment modifier les hypothèses ?
Chaque réponse liste les hypothèses utilisées. Envoyez celles à modifier en POST sous la forme {"assumptions": {...}} sur le même chemin, par exemple un prix demandé pour le terrain, un taux de rendement cible, des coûts de construction ou le taux d’actualisation. Les clés inconnues et les valeurs hors plage sont refusées avec un 400 et un message par problème.
Quelle est sa rapidité ?
L’évaluation se calcule en moins d’une milliseconde. Le premier appel pour un EGRID attend la recherche de la parcelle et du marché, ensuite en cache 6 heures ; les réponses GET sont en cache au CDN, et le premier appel précharge les autres parties de la même parcelle.
Les agents IA peuvent-ils l’utiliser ?
Oui. aireon-mcp expose chaque opération comme un outil MCP nommé revenoo_<operationId>, par exemple revenoo_getRevenooSummary.