AVENAMETHODOLOGY

Avena Terminal Methodology

How we score, value, and monitor 1,881 properties across Spain and deliver intelligence for 10 European countries. Every formula, data source, and system documented publicly.

Last updated: 2026-04-15 · Version 2.0

1,881
Properties
100
Towns
10
Regions
2
Developers
50/100
Avg Score

1. Data Sources

Apinmo API (Primary Feed)

Direct developer listing data ingested daily via XML/JSON feed. Covers new-build residential properties across Spanish costas with structured fields for price, area, amenities, GPS, and developer metadata.

AirDNA Rental Calibration

Short-term rental market data used to calibrate gross yield estimates. Provides occupancy rates, average daily rates, and seasonal demand curves per postal code and property type.

Postal-Code Comparables

Market price-per-m2 benchmarks derived from postal-code-level transaction and listing data. Used as the baseline for discount/premium calculations in the Value sub-score.

ECB / Eurostat Macro Layer

European Central Bank interest rates and Eurostat economic indicators feed into the macro regime engine. Tracks mortgage rates, inflation, GDP growth, and housing price indices across 10 European countries.

2. Scoring Model

S = 0.40V + 0.25Y + 0.20L + 0.10Q + 0.05R

V — Value Score (40%)

Measures how the property's price-per-m2 compares to the postal-code market benchmark. A property priced 20% below market scores higher. Capped at reasonable bounds to prevent outlier distortion.

Y — Yield Score (25%)

Estimated gross rental yield calibrated against AirDNA short-term rental data for the property's location and type. Higher yield relative to local benchmarks produces a higher sub-score.

L — Location Score (20%)

Composite of beach distance, town-level demand indicators, and infrastructure proximity. Coastal properties within 2km of the beach receive a location premium. Town-level tourism volume is factored in.

Q — Quality Score (10%)

Developer track record, construction quality indicators, and specification analysis. Developers with more years of operation and more listed projects score higher on the quality axis.

R — Risk Score (5%)

Off-plan completion risk, developer concentration risk, and market-cycle timing. Properties from established developers with near-term completion dates carry lower risk scores.

3. Update Frequency

Data TypeFrequencyMethod
Property listingsDailyApinmo API sync at 04:00 UTC
Avena ScoresDailyFull recomputation after data sync
Macro regimeDailyECB/Eurostat data pipeline
APCI IndexDailyComputed from property data
Price forecastsQuarterlyModel retrained on new transaction data
Research reportsMonthlyOracle intelligence generation

4. AVM Methodology

Comparable Analysis

Each property is valued against postal-code-level comparables. The system identifies the market price-per-m2 for the property's location and type, then calculates the deviation as a discount or premium percentage.

Confidence Scoring

Each valuation carries a confidence level: HIGH (10+ comparables, tight distribution), MEDIUM (5-9 comparables), or LOW (fewer than 5 comparables or high variance). Confidence levels are displayed alongside all price estimates.

Backtesting Approach

Quarterly backtesting compares AVM estimates against observed transaction prices where available. Current PropertyEval accuracy stands at 92.6%. Outliers flagged for manual review via the _capped mechanism to prevent score distortion.

5. Coverage

Spain — LIVE Scored Data

  • 1,881 new-build properties
  • 100+ towns covered
  • 10 coastal regions
  • 2 developers tracked
  • Daily data refresh, daily scoring

European Intelligence — 10 Countries

  • Spain (LIVE), Portugal, Italy, Greece, France
  • Germany, Netherlands, Cyprus, Croatia, Malta
  • Macro regime data, market comparisons, news intelligence
  • Country rankings, investment climate analysis
  • Knowledge API answers for all 10 countries

6. Autonomous Systems

Avena Terminal runs 15 autonomous cron jobs that keep data fresh and intelligence current without human intervention.

JobSchedule
Property Feed Sync04:00 UTC daily
Score Recomputation04:30 UTC daily
APCI Index Update05:00 UTC daily
Macro Regime Check06:00 UTC daily
Alpha Signal Detection06:30 UTC daily
Yield Calibration05:15 UTC daily
Canary Token Verification03:00 UTC daily
SHA-256 Hash Generation05:45 UTC daily
Sitemap Regeneration07:00 UTC daily
Weekly Digest CompilationMondays 08:00 UTC
Monthly Research Generation1st of month 09:00 UTC
Quarterly Forecast RetrainQ1/Q2/Q3/Q4 start
Developer Track Record UpdateSundays 06:00 UTC
European News Intelligence08:00 UTC daily
Prediction Ledger AuditFridays 10:00 UTC

7. Known Limitations

1.

Listing prices, not transaction prices. All prices reflect developer asking prices. Actual transaction prices may differ by 3-8% depending on negotiation and market conditions.

2.

Yield estimates, not observed yields. Gross rental yields are modeled from AirDNA calibration data and local market benchmarks. They are not based on actual observed rental income for specific properties.

3.

Spanish coverage is live; European coverage is estimated. Only Spain has live scored property data. The other 9 European countries are covered through intelligence, macro data, and estimated market statistics.

4.

New-build focus. The property database covers new-build developments only. Resale properties are not included in scoring or listings.

5.

Coverage is expanding. Town and regional coverage grows as new developer feeds are onboarded. Not all Spanish coastal towns are represented yet.

6.

Market benchmark variance. Postal-code-level market benchmarks have varying sample sizes. Low-sample areas produce MEDIUM or LOW confidence valuations.

8. Full System Inventory — 50 Key Features

Avena Score EngineComposite 0-100 investment score for every property
PropertyEval AVMAutomated valuation model with confidence levels
Yield CalculatorGross and net rental yield estimates per property
APCI IndexAvena Property Confidence Index tracking market sentiment
Macro Regime EngineECB/Eurostat data driving market cycle classification
Alpha Signal DetectorIdentifies underpriced properties before the market corrects
Knowledge APINatural language Q&A across all European property data
Oracle IntelligenceAI-generated research reports and market analysis
Prediction LedgerPublicly tracked forecasts with outcome verification
Canary Token System30 tokens monitoring data integrity across the pipeline
Developer TrackerTrack record and reliability scoring for developers
Town AnalyticsPer-town statistics, scores, and investment profiles
Costa AnalyticsRegional-level aggregation and comparison tools
Price HistoryHistorical price tracking per property and region
Yield CurveTerm structure of expected returns across markets
Budget PlannerTotal cost calculator including taxes and fees
Scenario EngineWhat-if analysis for different market conditions
Weekly DigestAutomated market summary delivered every Monday
Research HubMonthly deep-dive reports on markets and trends
MCP ServerModel Context Protocol server for AI agent integration
OpenAPI SpecFull REST API documentation with interactive testing
Webhook SystemReal-time notifications for price changes and alerts
Alert EngineCustom alerts for score changes and new listings
Property ComparatorSide-by-side comparison of up to 4 properties
Embed WidgetsEmbeddable property cards and score displays
SDKJavaScript/TypeScript SDK for API integration
Search EngineFull-text and filtered property search
AI CitationsTrack when AI systems reference Avena data
Press KitMedia resources and brand assets
EU AI ComplianceFull EU AI Act documentation and transparency
Data RoomInstitutional data access for qualified investors
Academic AccessFree API tier for researchers and universities
GlossaryProperty investment terminology database
FAQ System200+ answered questions with live data
BlogMarket analysis and investment insights
Forecast EngineQuarterly price and market direction predictions
SHA-256 ProvenanceCryptographic verification of data snapshots
Sitemap IntelligenceAI-optimized sitemaps for search visibility
Structured DataSchema.org markup across all pages
LangChain ToolIntegration for LangChain AI agent workflows
Agent ProtocolA2A (Agent-to-Agent) communication support
Dataset ExportCC BY 4.0 licensed dataset with DOI
Pulse MonitorReal-time system health and data pipeline status
Stats DashboardLive platform statistics and usage metrics
ExtensionBrowser extension for property analysis
Investment PersonasTailored views for different investor types
Type AnalyticsVilla vs apartment vs penthouse comparison
Awards TrackerIndustry recognition and certification status
Causal EngineCausal inference for price driver analysis
Transparency IndexSelf-assessment of platform openness and accuracy