Spec

Code snippets

curl "https://api.oanor.com/houseprices-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/houseprices-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/houseprices-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/houseprices-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "The nominal index is the headline price index; the real index is deflated by consumer prices, showing house prices relative to the cost of living (a negative real YoY means prices are falling after inflation). country is an ISO-2 code (US, DE, GB, JP) or a common name; XM is the euro area. Data is quarterly with the usual statistical lag.",
        "source": "BIS Data Portal (stats.bis.org/api/v2, dataflow WS_SPP, quarterly)",
        "service": "houseprices-api",
        "countries": 61,
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/latest": "Every country's latest house-price reading (nominal & real index + YoY), sortable (sort=nominal_yoy).",
            "GET /v1/country": "One country's latest reading (country=US or country=Germany).",
            "GET /v1/history": "One country's quarterly index history, nominal & real (country=US, quarters=40)."
        },
        "description": "How house prices are moving across the world, from the BIS Selected Residential Property Prices dataset. For ~60 countries it gives a quarterly residential property price index, nominal and real (inflation-adjusted), with year-on-year growth. latest returns every country's most recent reading (nominal & real index + YoY); country returns one country's latest; history returns its quarterly index time series. Live, no key, nothing stored. The real-estate / property-price macro data-cut, distinct from the FX-rate, yield-curve and equity APIs.",
        "latest_quarter": "2025-Q4",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-12T01:41:17.801Z",
        "request_id": "4349cc72-de4c-4aa4-b35f-38dc6ecf5277"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}