Skip to content

Market Data

The resource represents market data. This method returns marketdata based on the given financing terms query parameters. Returns a list of resources identified by the following URL. The offer resource is used to retrieve a marketdata based on the given financing terms query parameters. Right now only the average nominal interest rate (averageInterestRate) and the average effective interest rate (effectiveInterestRate) will be returned.

GET /financing/construction/v1.0/marketdata

Supported media types:
XML
JSON

Note The PAngBV (Preisangabenverordnung) requires that you need to provide the following data when displaying an offer: effective and nominal interest rates, monthly rate, remaining debt after fixed interest termination (Ablauf der Sollzinsbindung), number of repayment rates, duration until repayment is complete and the total amount paid. You may only use this API if you display all this data.

Request

Query Parameters

  • purchasePrice - purchase price of the project
  • ownFunds - own funds of the buyer
  • amortizationRate - amortization rate
  • fixedNominalInterestrate - fixed nominal interest rate (FIVE_YEARS, TEN_YEARS, FIFTEEN_YEARS, TWENTY_YEARS)
  • employment - employment of the buyer (CIVIL_SERVANT, EMPLOYED, FREELANCER, PENSIONER, SELFEMPLOYED,UNEMPLOYED)
  • providerType - favored provider types (AGENT, BANK, ALL)
  • geoCode - the region to get the average interest rates from; default: "1276" (Deutschland)
VALUE DESCRIPTION
1276001 Baden-Württemberg
1276002 Bayern
1276003 Berlin
1276004 Brandenburg
1276005 Bremen
1276006 Bremen
1276007 Bremen
1276008 Mecklenburg-Vorpommern
1276009 Niedersachsen
1276010 Nordrhein-Westfalen
1276011 Rheinland-Pfalz
1276012 Saarland
1276013 Sachsen
1276014 Sachsen-Anhalt
1276015 Schleswig-Holstei
1276016 Thüringen

Response

XML: 

1
2
3
4
5
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<ns2:marketdata>
    <averageInterestRate>2.07</averageInterestRate>
    <effectiveInterestRate>2.08</effectiveInterestRate>
</ns2:marketdata>

JSON: 

1
2
3
4
5
6
{
    "ns2:marketdata": {
        "averageInterestRate": "2.07",
        "effectiveInterestRate": "2.08"
    }
}