{"openapi":"3.1.0","info":{"title":"Residential Property Prices API","version":"1.0.0","description":"How house prices are moving across the world's economies, read live from the Bank for International Settlements' Selected Residential Property Prices dataset. For roughly 60 countries the BIS publishes a quarterly residential property price index — both nominal and real (inflation-adjusted) — together with its year-on-year change. The latest endpoint returns every country's most recent reading at once — the nominal and real index plus the nominal and real year-on-year growth — sortable by nominal or real YoY so you instantly see which housing markets are heating up and which are cooling once you strip out inflation. The country endpoint returns a single country's latest reading; the history endpoint returns its quarterly index time series (nominal and real) so you can chart a market over time. Countries are given as ISO-2 codes (US, DE, GB, JP) or common names (xm is the euro area). The nominal index is the headline price level; the real index is deflated by consumer prices, so a negative real YoY means prices are falling after inflation even when the nominal index still rises. This is the real-estate / property-price macro data-cut — distinct from the FX-rate, central-bank, yield-curve, commodity and equity-index APIs in the catalogue. Live source, no key required upstream, nothing stored.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/houseprices-api","description":"oanor gateway"}],"tags":[{"name":"House Prices"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/country":{"get":{"operationId":"get_v1_country","tags":["House Prices"],"summary":"One country's latest reading","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"ISO-2 code or common name","schema":{"type":"string"},"example":"US"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"period":"2025-Q4","source":"BIS","country":"US","real_index":158.4,"real_yoy_pct":-1.77,"nominal_index":235.4,"nominal_yoy_pct":0.87},"meta":{"timestamp":"2026-06-12T01:41:17.478Z","request_id":"84347391-9553-467d-b0eb-d62b813ef257"},"status":"ok","message":"Country retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/history":{"get":{"operationId":"get_v1_history","tags":["House Prices"],"summary":"One country's quarterly index history","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"ISO-2 code or common name","schema":{"type":"string"},"example":"US"},{"name":"quarters","in":"query","required":false,"description":"Number of recent quarters (1-200, default 40)","schema":{"type":"string"},"example":"40"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":40,"source":"BIS","country":"US","history":[{"period":"2016-Q1","real_index":118.8,"nominal_index":129.4},{"period":"2016-Q2","real_index":118.8,"nominal_index":130.8},{"period":"2016-Q3","real_index":120,"nominal_index":132.6},{"period":"2016-Q4","real_index":121.6,"nominal_index":134.7},{"period":"2017-Q1","real_index":122.3,"nominal_index":136.5},{"period":"2017-Q2","real_index":123.4,"nominal_index":138.5},{"period":"2017-Q3","real_index":124.8,"nominal_index":140.6},{"period":"2017-Q4","real_index":126.3,"nominal_index":142.8},{"period":"2018-Q1","real_index":127.1,"nominal_index":145},{"period":"2018-Q2","real_index":127.3,"nominal_index":146.7},{"period":"2018-Q3","real_index":128.1,"nominal_index":148.2},{"period":"2018-Q4","real_index":129.3,"nominal_index":149.5},{"period":"2019-Q1","real_index":129.8,"nominal_index":150.6},{"period":"2019-Q2","real_index":129.6,"nominal_index":152.1},{"period":"2019-Q3","real_index":130.8,"nominal_index":153.9},{"period":"2019-Q4","real_index":132.4,"nominal_index":156.2},{"period":"2020-Q1","real_index":133.8,"nominal_index":158.5},{"period":"2020-Q2","real_index":135.7,"nominal_index":159.8},{"period":"2020-Q3","real_index":138.4,"nominal_index":164.9},{"period":"2020-Q4","real_index":143.3,"nominal_index":171.1},{"period":"2021-Q1","real_index":146.2,"nominal_index":176.4},{"period":"2021-Q2","real_index":149.6,"nominal_index":184.7},{"period":"2021-Q3","real_index":153.4,"nominal_index":192.5},{"period":"2021-Q4","real_index":157,"nominal_index":200},{"period":"2022-Q1","real_index":159.9,"nominal_index":208.4},{"period":"2022-Q2","real_index":159.7,"nominal_index":214.2},{"period":"2022-Q3","real_index":156.7,"nominal_index":213},{"period":"2022-Q4","real_index":156.7,"nominal_index":213.8},{"period":"2023-Q1","real_index":156.7,"nominal_index":216.1},{"period":"2023-Q2","real_index":156.9,"nominal_index":219},{"period":"2023-Q3","real_index":158.4,"nominal_index":223},{"period":"2023-Q4","real_index":160.1,"nominal_index":225.5},{"period":"2024-Q1","real_index":160,"nominal_index":227.7},{"period":"2024-Q2","real_index":159.4,"nominal_index":229.4},{"period":"2024-Q3","real_index":160.2,"nominal_index":231.3},{"period":"2024-Q4","real_index":161.2,"nominal_index":233.3},{"period":"2025-Q1","real_index":159.9,"nominal_index":233.8},{"period":"2025-Q2","real_index":158.5,"nominal_index":233.8},{"period":"2025-Q3","real_index":157.7,"nominal_index":234.3},{"period":"2025-Q4","real_index":158.4,"nominal_index":235.4}]},"meta":{"timestamp":"2026-06-12T01:41:17.626Z","request_id":"6fafb3f2-6a87-489e-883e-4025a30cc78f"},"status":"ok","message":"History retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/latest":{"get":{"operationId":"get_v1_latest","tags":["House Prices"],"summary":"Every country's latest house-price reading","description":"","parameters":[{"name":"sort","in":"query","required":false,"description":"Sort order: nominal_yoy (default), real_yoy or country","schema":{"type":"string"},"example":"nominal_yoy"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":61,"source":"BIS","countries":[{"period":"2025-Q4","country":"TR","real_index":220.8,"real_yoy_pct":-0.75,"nominal_index":4310.7,"nominal_yoy_pct":30.62},{"period":"2025-Q4","country":"MK","real_index":123,"real_yoy_pct":19.96,"nominal_index":199,"nominal_yoy_pct":25.01},{"period":"2025-Q4","country":"HU","real_index":216.1,"real_yoy_pct":16.83,"nominal_index":416.9,"nominal_yoy_pct":21.24},{"period":"2025-Q4","country":"PT","real_index":196.2,"real_yoy_pct":16.28,"nominal_index":261,"nominal_yoy_pct":18.89},{"period":"2025-Q4","country":"HR","real_index":147.3,"real_yoy_pct":12.01,"nominal_index":215.3,"nominal_yoy_pct":16.05},{"period":"2025-Q4","country":"RU","real_index":76.4,"real_yoy_pct":7.16,"nominal_index":219.4,"nominal_yoy_pct":14.27},{"period":"2025-Q4","country":"CO","real_index":142.5,"real_yoy_pct":7.2,"nominal_index":297.7,"nominal_yoy_pct":12.89},{"period":"2025-Q4","country":"ES","real_index":102.2,"real_yoy_pct":9.57,"nominal_index":139.3,"nominal_yoy_pct":12.87},{"period":"2025-Q4","country":"SK","real_index":135.9,"real_yoy_pct":8.64,"nominal_index":221.3,"nominal_yoy_pct":12.73},{"period":"2025-Q4","country":"BG","real_index":147.3,"real_yoy_pct":7.04,"nominal_index":242.6,"nominal_yoy_pct":12.59},{"period":"2025-Q4","country":"LV","real_index":170.6,"real_yoy_pct":6.91,"nominal_index":278.8,"nominal_yoy_pct":10.96},{"period":"2025-Q4","country":"LT","real_index":185,"real_yoy_pct":6.79,"nominal_index":318.5,"nominal_yoy_pct":10.84},{"period":"2025-Q4","country":"CZ","real_index":159.6,"real_yoy_pct":7.96,"nominal_index":266.8,"nominal_yoy_pct":10.38},{"period":"2025-Q4","country":"MX","real_index":153.5,"real_yoy_pct":5.05,"nominal_index":297.8,"nominal_yoy_pct":8.92},{"period":"2025-Q4","country":"AU","real_index":140.4,"real_yoy_pct":4.05,"nominal_index":211,"nominal_yoy_pct":7.82},{"period":"2025-Q4","country":"DK","real_index":132.5,"real_yoy_pct":5.47,"nominal_index":172.8,"nominal_yoy_pct":7.63},{"period":"2025-Q4","country":"GR","real_index":96.1,"real_yoy_pct":5.17,"nominal_index":118.4,"nominal_yoy_pct":7.62},{"period":"2025-Q4","country":"CY","real_index":87.7,"real_yoy_pct":7.57,"nominal_index":105.1,"nominal_yoy_pct":7.07},{"period":"2025-Q4","country":"IE","real_index":146,"real_yoy_pct":3.91,"nominal_index":191.8,"nominal_yoy_pct":6.97},{"period":"2025-Q4","country":"RO","real_index":71.6,"real_yoy_pct":-2.53,"nominal_index":141.4,"nominal_yoy_pct":6.96},{"period":"2025-Q4","country":"NL","real_index":132.6,"real_yoy_pct":3.12,"nominal_index":196.4,"nominal_yoy_pct":6.15},{"period":"2025-Q4","country":"MT","real_index":143.2,"real_yoy_pct":3.39,"nominal_index":194.8,"nominal_yoy_pct":6.14},{"period":"2025-Q4","country":"PE","real_index":113.5,"real_yoy_pct":4.63,"nominal_index":186.2,"nominal_yoy_pct":6.1},{"period":"2025-Q4","country":"NO","real_index":131.3,"real_yoy_pct":2.79,"nominal_index":198.1,"nominal_yoy_pct":5.94},{"period":"2025-Q4","country":"SI","real_index":133.4,"real_yoy_pct":2.98,"nominal_index":185.6,"nominal_yoy_pct":5.77},{"period":"2025-Q4","country":"RS","real_index":120.3,"real_yoy_pct":2.86,"nominal_index":251.9,"nominal_yoy_pct":5.7},{"period":"2025-Q4","country":"CL","real_index":206.1,"real_yoy_pct":2.03,"nominal_index":385.7,"nominal_yoy_pct":5.55},{"period":"2025-Q4","country":"EE","real_index":191.2,"real_yoy_pct":0.99,"nominal_index":346.2,"nominal_yoy_pct":5.55},{"period":"2025-Q4","country":"ZA","real_index":89.5,"real_yoy_pct":1.78,"nominal_index":189,"nominal_yoy_pct":5.42},{"period":"2025-Q4","country":"XM","real_index":111.7,"real_yoy_pct":2.97,"nominal_index":155.3,"nominal_yoy_pct":5.09},{"period":"2025-Q4","country":"JP","real_index":121.4,"real_yoy_pct":2.31,"nominal_index":144.6,"nominal_yoy_pct":5.04},{"period":"2025-Q4","country":"PL","real_index":121.8,"real_yoy_pct":1.79,"nominal_index":209.1,"nominal_yoy_pct":4.33},{"period":"2025-Q4","country":"BR","real_index":91.1,"real_yoy_pct":-0.3,"nominal_index":215.9,"nominal_yoy_pct":4.15},{"period":"2025-Q4","country":"IT","real_index":75.9,"real_yoy_pct":2.87,"nominal_index":100,"nominal_yoy_pct":4.05},{"period":"2025-Q4","country":"CH","real_index":161.4,"real_yoy_pct":3.88,"nominal_index":170,"nominal_yoy_pct":3.94},{"period":"2025-Q4","country":"IS","real_index":204.3,"real_yoy_pct":-0.5,"nominal_index":372.2,"nominal_yoy_pct":3.65},{"period":"2025-Q4","country":"IN","real_index":162.6,"real_yoy_pct":3,"nominal_index":366,"nominal_yoy_pct":3.58},{"period":"2025-Q4","country":"BE","real_index":109.7,"real_yoy_pct":1.28,"nominal_index":160.6,"nominal_yoy_pct":3.46},{"period":"2025-Q4","country":"SG","real_index":120.4,"real_yoy_pct":2.12,"nominal_index":162.9,"nominal_yoy_pct":3.34},{"period":"2025-Q4","country":"DE","real_index":129.3,"real_yoy_pct":0.85,"nominal_index":180.1,"nominal_yoy_pct":3.03},{"period":"2025-Q4","country":"5R","real_index":132.3,"real_yoy_pct":0.35,"nominal_index":187.1,"nominal_yoy_pct":2.81},{"period":"2025-Q4","country":"HK","real_index":133.3,"real_yoy_pct":1.17,"nominal_index":197.3,"nominal_yoy_pct":2.48},{"period":"2025-Q4","country":"GB","real_index":110.5,"real_yoy_pct":-0.88,"nominal_index":172.7,"nominal_yoy_pct":2.47},{"period":"2025-Q4","country":"AT","real_index":136.5,"real_yoy_pct":-1.75,"nominal_index":211.5,"nominal_yoy_pct":2.12},{"period":"2025-Q4","country":"XW","real_index":119.7,"real_yoy_pct":-0.6,"nominal_index":195.9,"nominal_yoy_pct":2.05},{"period":"2025-Q4","country":"PH","real_index":177.1,"real_yoy_pct":-0.08,"nominal_index":289.8,"nominal_yoy_pct":1.57},{"period":"2025-Q4","country":"MY","real_index":171.7,"real_yoy_pct":0.07,"nominal_index":232.1,"nominal_yoy_pct":1.47},{"period":"2025-Q4","country":"4T","real_index":109.3,"real_yoy_pct":-1.39,"nominal_index":208.7,"nominal_yoy_pct":1.43},{"period":"2025-Q4","country":"SE","real_index":131,"real_yoy_pct":0.69,"nominal_index":181.2,"nominal_yoy_pct":1.19},{"period":"2025-Q4","country":"FR","real_index":100.2,"real_yoy_pct":0.15,"nominal_index":127.9,"nominal_yoy_pct":1.03},{"period":"2025-Q4","country":"US","real_index":158.4,"real_yoy_pct":-1.77,"nominal_index":235.4,"nominal_yoy_pct":0.87},{"period":"2025-Q4","country":"ID","real_index":94.4,"real_yoy_pct":-1.95,"nominal_index":168,"nominal_yoy_pct":0.83},{"period":"2025-Q4","country":"KR","real_index":105.7,"real_yoy_pct":-1.64,"nominal_index":143.7,"nominal_yoy_pct":0.7},{"period":"2025-Q4","country":"TH","real_index":149.4,"real_yoy_pct":1.15,"nominal_index":182.6,"nominal_yoy_pct":0.63},{"period":"2025-Q4","country":"MA","real_index":80,"real_yoy_pct":0.45,"nominal_index":103.6,"nominal_yoy_pct":0.28},{"period":"2025-Q4","country":"LU","real_index":148.9,"real_yoy_pct":-2.81,"nominal_index":205.1,"nominal_yoy_pct":0.06},{"period":"2025-Q4","country":"IL","real_index":180,"real_yoy_pct":-2.69,"nominal_index":228.4,"nominal_yoy_pct":-0.27},{"period":"2025-Q4","country":"NZ","real_index":157.5,"real_yoy_pct":-4.24,"nominal_index":230.7,"nominal_yoy_pct":-1.26},{"period":"2025-Q4","country":"FI","real_index":77.8,"real_yoy_pct":-3.18,"nominal_index":103.7,"nominal_yoy_pct":-3.18},{"period":"2025-Q4","country":"CA","real_index":142.3,"real_yoy_pct":-5.51,"nominal_index":201.8,"nominal_yoy_pct":-3.38},{"period":"2025-Q4","country":"CN","real_index":86.8,"real_yoy_pct":-6.27,"nominal_index":115.7,"nominal_yoy_pct":-5.74}],"latest_quarter":"2025-Q4"},"meta":{"timestamp":"2026-06-12T01:41:17.702Z","request_id":"044151fe-70ae-4001-a650-ac9d41abde23"},"status":"ok","message":"Latest retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":350,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1137,"monthly_call_quota":6800,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3421,"monthly_call_quota":43500,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7953,"monthly_call_quota":235000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/houseprices-api"}