Authenticatie, invoer en resultaat
Headers
Content-Type
string
application/json
x-api-key*
string
Unieke API-sleutel van Altum. Verkrijg er een via Mopsus (https://mopsus.altum.ai)
Dit is de hoofdendpoint van de API. Deze haalt een lijst met subsidies op op basis van de postcode van een gebruiker en, indien opgegeven, hun persoonlijke en financiële gegevens voor leen-geschiktheid.
GET: https://api.altum.ai/market-trend
Request body
Markettrend Request Model
Veld
Type
Beschrijving
postcode*
string
Verplicht. De Nederlandse postcode (bijv. "3511 AA")
Example Complete Input
Een geldige GET aanvraagtekst ziet er als volgt uit:
{
"postcode": "5258BA"
}Bij een succesvolle GET -aanvraag retourneert de API de status 200 OK met een JSON-object dat de resultaten bevat.
Market Trend API Response Model
Veld
Type
Beschrijving
postcode
String
De genormaliseerde Nederlandse postcode (bijv. "1011AB") die voor de query is gebruikt.
city
String
De plaatsnaam afgeleid van de adresstamgegevens.
neighbourhood
String
De specifieke buurtnaam (indien beschikbaar in Dataland-bron).
municipality
String
De administratieve gemeente waaronder het gebied valt.
averagePriceSingleFamilyHomes
Float
De gemiddelde transactieprijs voor eengezinswoningen (vrijstaand, twee-onder-een-kap, tussenwoningen).
averagePriceMultiFamilyHomes
Float
De gemiddelde transactieprijs voor meergezinswoningen (appartementen/flats).
pricePerSquareMeterSingleFamily
Float
De gemiddelde prijs per vierkante meter (€/m²) voor eengezinswoningen.
pricePerSquareMeterMultiFamily
Float
De gemiddelde prijs per vierkante meter (€/m²) voor appartementen.
annualPriceChange
Float
De jaarlijkse procentuele groei (CAGR) van vastgoedwaarden vergeleken met het voorgaande geregistreerde jaar.
fiveYearPriceChange
Float
De geprojecteerde procentuele waardeverandering over een periode van 5 jaar op basis van historische groeitrends.
totalSalesLast12Months
Integer
Het totaal aantal vastgoedtransacties dat de afgelopen 365 dagen in deze postcode is geregistreerd.
priceDistribution
Object
Een dictionary die dient als histogram, waarbij prijsklassen (bijv. "250-500k") worden gekoppeld aan het aantal verkochte panden in die categorie.
pricePerSquareMeterDistribution
Object
Een dictionary die dient als histogram, waarbij prijs-per-m²-klassen (bijv. "3000-3500") worden gekoppeld aan de verkoopfrekwentie in die categorie.
Output
Voorbeeld volledige output
Explanation
🏘️ Regio
Alle gegevens en KPI’s zijn berekend voor postcode 5258BB, met context op stad BERLICUM NB, wijk Berlicum en gemeente Sint-Michielsgestel.
💰 Gemiddelde woningprijzen
Eengezinswoningen: gemiddeld €681.870
Meergezinswoningen / appartementen: geen gegevens beschikbaar voor dit gebied
Dit laat zien dat huizen in deze postcode relatief duur zijn, en dat de markt voor appartementen klein of niet geregistreerd is.
📏 Prijs per vierkante meter
Eengezinswoningen: €1.035 per m²
Meergezinswoningen: geen gegevens beschikbaar
Dit geeft een manier om huizenprijzen eerlijk te vergelijken, zelfs als de woningen verschillen in grootte.
📈 Prijsontwikkelingen
Jaarlijkse prijsverandering: +6,7% → prijzen zijn het afgelopen jaar gestegen
Vijfjarige prijsverandering: +38,1% → prijzen zijn de afgelopen 5 jaar aanzienlijk gestegen
Dit laat zien dat de huizenprijzen zowel op korte als lange termijn stijgen.
🏷️ Transactie-activiteit
Aantal verkopen in de laatste 12 maanden: 0
Er zijn het afgelopen jaar geen huizen verkocht in dit gebied, dus de markt is momenteel inactief.
💵 Prijsverdeling
Aantal huizen verkocht per prijsklasse (historisch, niet alleen de laatste 12 maanden):
€250k–€500k → 2 huizen
€500k–€750k → 4 huizen
€1M+ → 2 huizen
De meeste verkochte huizen in deze postcode liggen in de €500k–€750k range, met enkele dure verkopen boven €1M.
🏠 Verdeling prijs per vierkante meter
Alle 8 geregistreerde verkopen liggen in de 0–2.500 €/m² range.
Dit laat zien dat zelfs dure huizen relatief bescheiden geprijsd zijn per m² vergeleken met zeer luxe markten.
Het postcodeformaat was onjuist (bijv. "12345")
Last updated