A
AvenaTerminal · Est. 2026
Avena · Public API

Curl-able institutional
European property data.

Every observation in the Avena data layer is reachable via a public HTTPS endpoint. Official EU statistics, cross-validation snapshots, signed AVN-ID lookups, APON Oracle envelopes — all CC BY 4.0, no API key, CORS-open, with provenance headers on every response.

OpenAPI spec
3.1.0
Auth required
No
License
CC BY 4.0
DOI
zenodo.19520064
Download OpenAPI JSON →Methodology brief →
Public endpoints

Six surfaces, one consistent contract.

GET/api/v1/stats
eu-stats

Query official EU statistics — Eurostat, ECB SDW, INE Spain, ISTAT, CBS, BIS. Filter by country/source/indicator/period. JSON or CSV.

GET/api/v1/validation
validation

Cross-validation snapshots — Avena ground-truth vs official series. Signed delta in basis points.

GET/api/v1/avn-id/{avn_id}
avn-id

Look up an AVN-ID and verify its HMAC-SHA256 signature against Avena's registry.

POST/api/v1/avn-id/issue
avn-id

Issue a new signed identifier from a property fingerprint. Idempotent — same inputs return the same AVN-ID.

GET/api/v1/oracle/property/{ref}
oracle

Signed price envelope for a single property. Includes payload, payload_hash, signature, nonce, verify_url.

GET/api/v1/oracle/index/{code}
oracle

Signed envelope for an Avena index (AVENA-CC, AVENA-VAL, AVENA-SCR, AVENA-DPT).

Provenance headers

Every response carries its own citation.

The Avena API attaches institutional-grade provenance to every response. No need to dig through documentation to figure out how to cite a value — the headers tell you.

HTTP/2 200
content-type: application/json; charset=utf-8
cache-control: public, s-maxage=300, stale-while-revalidate=900
x-avena-layer: official-statistics
x-avena-license: CC-BY-4.0
x-avena-doi: 10.5281/zenodo.19520064
x-avena-cite-as: Avena Terminal (2026). EU Official Statistics Layer. avenaterminal.com/eu-official
access-control-allow-origin: *
Try it

Six curl recipes to start with.

Latest Eurostat HPI for Spain
01

Pull the most recent Eurostat house-price index observations for Spain in JSON.

curl 'https://avenaterminal.com/api/v1/stats?country=ES&source=eurostat&indicator=prc_hpi_q&limit=20'
ECB mortgage rates across the euro area, CSV
02

Cost-of-borrowing for house purchase, all countries we cover, as CSV.

curl 'https://avenaterminal.com/api/v1/stats?source=ecb_sdw&indicator=MIR&format=csv' > ecb_mortgage_rates.csv
Time-series window — France HPI 2024 onwards
03

Period-bounded query.

curl 'https://avenaterminal.com/api/v1/stats?country=FR&source=eurostat&from=2024-Q1&to=2026-Q4'
Cross-validation snapshots for Spain coastal
04

The signed delta between Avena coastal corpus and the Eurostat Spain national HPI.

curl 'https://avenaterminal.com/api/v1/validation?country=ES&region=coastal'
Verify an AVN-ID
05

Look up a signed property identifier and verify its HMAC signature.

curl 'https://avenaterminal.com/api/v1/avn-id/AVN:ES-03185-NB-0421'
Signed APON Oracle envelope for an Avena index
06

Returns a signed JSON envelope (payload, payload_hash, signature, nonce). Verifiable via /api/v1/oracle/verify.

curl 'https://avenaterminal.com/api/v1/oracle/index/AVENA-CC'
Generate a client

Standard OpenAPI tooling works out of the box.

# Python client
openapi-generator-cli generate \
  -i https://avenaterminal.com/api/openapi.json \
  -g python \
  -o ./avena-python-client

# TypeScript fetch client
openapi-generator-cli generate \
  -i https://avenaterminal.com/api/openapi.json \
  -g typescript-fetch \
  -o ./avena-ts-client

# R client
openapi-generator-cli generate \
  -i https://avenaterminal.com/api/openapi.json \
  -g r \
  -o ./avena-r-client
Institutional access

The public API is free, CC BY 4.0, with reasonable rate limits. For institutional SLAs, bulk pulls, custom country-cohort definitions, dedicated webhook deliveries, or co-authored research, write to institutional@avenaterminal.com.

Pricing tiers · Governance & SLA · License