finwire.pl - Polish financial data
Live Polish rates, FX, housing prices, rents, credit market, legal limits and macro data.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (4)
- LOWin get_currency_rates
- LOWin get_housing_prices
- LOWin get_rents
- LOWin get_credit_market
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"data": {
"url": "https://public-api.finwire.pl/mcp"
}
}
}Remote-Endpunkte
https://public-api.finwire.pl/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (23)
🟢get_macro_snapshot
Start here for "how is the Polish economy doing" or a briefing. Returns the six headline indicators (GDP, inflation, unemployment, wages, rates and similar) with latest reading, change and freshness, which indicators changed recently, and the next releases and RPP meetings.
Eingabe-Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"headline": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"group": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"display": {
"type": "string"
},
"value": {
"type": "number"
},
"unit": {
"type": "string"
},
"period": {
"type": "string"
},
"periodLabel": {
"type": [
"string",
"null"
]
},
"periodType": {
"type": "string"
},
"previousDisplay": {
"type": [
"string",
"null"
]
},
"previousPeriod": {
"type": [
"string",
"null"
]
},
"changeDisplay": {
"type": [
"string",
"null"
]
},
"change": {
"type": [
"number",
"null"
]
},
"changeKind": {
"type": "string"
},
"direction": {
"type": [
"string",
"null"
]
},
"tone": {
"type": [
"string",
"null"
]
},
"nextRelease": {
"type": [
"string",
"null"
]
},
"daysToNextRelease": {
"type": [
"integer",
"null"
]
},
"updatedAt": {
"type": [
"string",
"null"
]
},
"freshness": {
"type": "string",
"enum": [
"new",
"current",
"stale"
]
},
"source": {
"type": [
"string",
"null"
]
},
"sourceUrl": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
}
},
"required": [
"key",
"label",
"display",
"value",
"period",
"freshness",
"url"
]
}
},
"recentlyChanged": {
"type": "array",
"items": {
"type": "string"
}
},
"upcoming": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": [
"string",
"null"
]
},
"time": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"titleEn": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"importance": {
"type": [
"number",
"null"
]
},
"tentative": {
"type": "boolean"
}
}
}
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"headline",
"upcoming",
"serverDate",
"citation"
]
}🟢list_macro_indicators(group, query, include_descriptions)
Find indicators and their keys. Latest reading, change, next release and source for GDP, CPI and core inflation, unemployment, wages, retail sales, industrial output, NBP rates, FX, consumer sentiment, mortgage market and statutory limits. Filter by group or free text (Polish or English words, e.g. "inflacja", "wages"). Set include_descriptions to learn what each series measures when keys look alike (cpi-rr vs hicp-rr).
Eingabe-Schema
{
"type": "object",
"properties": {
"group": {
"type": "string",
"enum": [
"wzrost",
"ceny",
"praca",
"stopy",
"nastroje",
"nieruchomosci",
"limity"
],
"description": "Indicator group."
},
"query": {
"type": "string",
"maxLength": 80,
"description": "Case-insensitive text matched against key and label."
},
"include_descriptions": {
"type": "boolean",
"description": "Add a one-sentence explanation per indicator. Default false."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"count": {
"type": "integer"
},
"indicators": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"group": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"display": {
"type": "string"
},
"value": {
"type": "number"
},
"unit": {
"type": "string"
},
"period": {
"type": "string"
},
"periodLabel": {
"type": [
"string",
"null"
]
},
"periodType": {
"type": "string"
},
"previousDisplay": {
"type": [
"string",
"null"
]
},
"previousPeriod": {
"type": [
"string",
"null"
]
},
"changeDisplay": {
"type": [
"string",
"null"
]
},
"change": {
"type": [
"number",
"null"
]
},
"changeKind": {
"type": "string"
},
"direction": {
"type": [
"string",
"null"
]
},
"tone": {
"type": [
"string",
"null"
]
},
"nextRelease": {
"type": [
"string",
"null"
]
},
"daysToNextRelease": {
"type": [
"integer",
"null"
]
},
"updatedAt": {
"type": [
"string",
"null"
]
},
"freshness": {
"type": "string",
"enum": [
"new",
"current",
"stale"
]
},
"source": {
"type": [
"string",
"null"
]
},
"sourceUrl": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
}
},
"required": [
"key",
"label",
"display",
"value",
"period",
"freshness",
"url"
]
}
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"count",
"indicators",
"serverDate",
"citation"
]
}🟢get_macro_indicator(key, from)
One indicator by key with its meaning, latest reading, freshness, next release and history (oldest first) with min and max over the window. Use for "what is the current X", "how has X changed".
Eingabe-Schema
{
"type": "object",
"properties": {
"key": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$",
"description": "Indicator key from list_macro_indicators, e.g. \"cpi-rr\"."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"description": "First month of history, YYYY-MM. Default: last 5 years."
}
},
"required": [
"key"
],
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"indicator": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"group": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"display": {
"type": "string"
},
"value": {
"type": "number"
},
"unit": {
"type": "string"
},
"period": {
"type": "string"
},
"periodLabel": {
"type": [
"string",
"null"
]
},
"periodType": {
"type": "string"
},
"previousDisplay": {
"type": [
"string",
"null"
]
},
"previousPeriod": {
"type": [
"string",
"null"
]
},
"changeDisplay": {
"type": [
"string",
"null"
]
},
"change": {
"type": [
"number",
"null"
]
},
"changeKind": {
"type": "string"
},
"direction": {
"type": [
"string",
"null"
]
},
"tone": {
"type": [
"string",
"null"
]
},
"nextRelease": {
"type": [
"string",
"null"
]
},
"daysToNextRelease": {
"type": [
"integer",
"null"
]
},
"updatedAt": {
"type": [
"string",
"null"
]
},
"freshness": {
"type": "string",
"enum": [
"new",
"current",
"stale"
]
},
"source": {
"type": [
"string",
"null"
]
},
"sourceUrl": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
}
},
"required": [
"key",
"label",
"display",
"value",
"period",
"freshness",
"url"
]
},
"history": {
"type": "object",
"properties": {
"from": {
"type": "string"
},
"count": {
"type": "integer"
},
"points": {
"type": "array",
"items": {
"type": "object",
"properties": {
"period": {
"type": "string"
},
"value": {
"type": [
"number",
"null"
]
}
},
"required": [
"period"
]
}
},
"min": {
"type": [
"object",
"null"
],
"properties": {
"period": {
"type": "string"
},
"value": {
"type": "number"
}
}
},
"max": {
"type": [
"object",
"null"
],
"properties": {
"period": {
"type": "string"
},
"value": {
"type": "number"
}
}
}
},
"required": [
"from",
"count",
"points"
]
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"indicator",
"history",
"serverDate",
"citation"
]
}🟢compare_macro_indicators(keys, from)
History of 2-4 indicators aligned by period, for questions like "are wages growing faster than prices". All keys must have the same frequency (all monthly, or all quarterly); otherwise the call fails and says which differ.
Eingabe-Schema
{
"type": "object",
"properties": {
"keys": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$",
"description": "Indicator key from list_macro_indicators, e.g. \"cpi-rr\"."
},
"minItems": 2,
"maxItems": 4
},
"from": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"description": "First month of history, YYYY-MM. Default: last 5 years."
}
},
"required": [
"keys"
],
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"periodType": {
"type": "string"
},
"periods": {
"type": "array",
"items": {
"type": "string"
}
},
"series": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"unit": {
"type": "string"
},
"url": {
"type": "string"
},
"values": {
"type": "array",
"items": {
"type": [
"number",
"null"
]
}
}
},
"required": [
"key",
"values"
]
}
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"periodType",
"periods",
"series",
"serverDate",
"citation"
]
}🟢get_macro_changes(days)
Indicators whose reading was updated in the last N days (newest first), with the change against the previous reading.
Eingabe-Schema
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"minimum": 1,
"maximum": 60,
"description": "Look-back window, default 7."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"days": {
"type": "integer"
},
"count": {
"type": "integer"
},
"changed": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"group": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"display": {
"type": "string"
},
"value": {
"type": "number"
},
"unit": {
"type": "string"
},
"period": {
"type": "string"
},
"periodLabel": {
"type": [
"string",
"null"
]
},
"periodType": {
"type": "string"
},
"previousDisplay": {
"type": [
"string",
"null"
]
},
"previousPeriod": {
"type": [
"string",
"null"
]
},
"changeDisplay": {
"type": [
"string",
"null"
]
},
"change": {
"type": [
"number",
"null"
]
},
"changeKind": {
"type": "string"
},
"direction": {
"type": [
"string",
"null"
]
},
"tone": {
"type": [
"string",
"null"
]
},
"nextRelease": {
"type": [
"string",
"null"
]
},
"daysToNextRelease": {
"type": [
"integer",
"null"
]
},
"updatedAt": {
"type": [
"string",
"null"
]
},
"freshness": {
"type": "string",
"enum": [
"new",
"current",
"stale"
]
},
"source": {
"type": [
"string",
"null"
]
},
"sourceUrl": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
}
},
"required": [
"key",
"label",
"display",
"value",
"period",
"freshness",
"url"
]
}
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"days",
"count",
"changed",
"serverDate",
"citation"
]
}🟢get_macro_calendar(limit)
Upcoming Polish macro releases and decisions (RPP rate decisions, CPI, wages, GDP, industrial output) with date, time and importance (higher is more important). Dates marked tentative may move.
Eingabe-Schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Number of events, default 10."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"count": {
"type": "integer"
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": [
"string",
"null"
]
},
"time": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"titleEn": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"importance": {
"type": [
"number",
"null"
]
},
"tentative": {
"type": "boolean"
}
}
}
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"count",
"events",
"serverDate",
"citation"
]
}🟢search_datasets(query, category)
Catalog of all finwire.pl datasets (rates, FX, gold, fuel and energy prices, Finwire Nowcast, broker fees, housing prices and rents, credit market, legal limits and law changes, regional income, Europe) with the best tool to call, its parameters, license and finwire.pl page. Use when no other tool obviously fits.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 80,
"description": "Words in Polish or English, e.g. \"czynsze\", \"mortgage\", \"podatek\"."
},
"category": {
"type": "string",
"enum": [
"series",
"real-estate",
"calendar",
"index",
"market",
"snapshot",
"insight"
],
"description": "Dataset category."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"count": {
"type": "integer"
},
"datasets": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"category": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"source": {
"type": "string"
},
"license": {
"type": "string"
},
"tool": {
"type": "string"
},
"params": {
"type": "object"
},
"url": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"id",
"title",
"tool",
"url",
"docsUrl"
]
}
},
"serverDate": {
"type": "string"
},
"citation": {
"type": "string"
}
},
"required": [
"count",
"datasets",
"serverDate",
"citation"
]
}🟢get_dataset(id, params)
Any dataset by id from search_datasets, with optional params listed there. Returns the same data as the public REST API /v1 (long lists shortened). Prefer the dedicated tools when one fits.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"enum": [
"interest-rates",
"cpi",
"fx",
"housing",
"bonds",
"wages",
"legal-limits",
"bond-yields",
"unemployment",
"wages-by-occupation",
"local-tax",
"transaction-prices",
"rent",
"rental-yield",
"housing-supply",
"economic-calendar",
"entry-threshold",
"credit-market-index",
"credit-stress",
"real-deposit-rate",
"housing-affordability",
"credit-cost",
"borrowing-power",
"purchasing-power",
"deposit-rates",
"savings-rates",
"mortgage-rates",
"cash-loan-rates",
"gold",
"fuel-max-prices",
"energy-tariffs",
"nowcast",
"broker-fees",
"macro-indicators",
"consumer-sentiment",
"wages-enterprise",
"municipal-income",
"legal-changes",
"housing-upkeep",
"eu-housing",
"credit-survey",
"nbp-monetary",
"ecb-mortgage-rates",
"snapshot"
],
"description": "Dataset id."
},
"params": {
"type": "object",
"additionalProperties": {
"type": [
"string",
"number"
]
},
"description": "Optional parameters of the dataset, e.g. {\"city\": \"gdansk\"}."
}
},
"required": [
"id"
],
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"datasetId": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": [
"object",
"array",
"null"
]
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"license": {
"type": "string"
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"datasetId",
"title",
"summary",
"url",
"serverDate",
"source",
"license",
"citation",
"docsUrl"
]
}🟢get_interest_rates(rate, days)
Current NBP policy rates (reference, lombard, deposit, rediscount, discount) with the date of the last change, or the history of one rate. WIBOR and POLSTR are not available (GPW Benchmark license).
Eingabe-Schema
{
"type": "object",
"properties": {
"rate": {
"type": "string",
"pattern": "^stopa-[a-z]+$",
"description": "Rate id for history, e.g. \"stopa-referencyjna\". Omit for all current rates."
},
"days": {
"type": "integer",
"minimum": 7,
"maximum": 3650,
"description": "History window in days, default 365."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"datasetId": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": [
"object",
"array",
"null"
]
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"license": {
"type": "string"
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"datasetId",
"title",
"summary",
"url",
"serverDate",
"source",
"license",
"citation",
"docsUrl"
]
}🟢get_currency_rates(code, days)
NBP mid, bid and ask rates of currencies against PLN (table), the history of one currency, or the NBP gold price (code "XAU").
Eingabe-Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"pattern": "^[A-Za-z]{3,4}$",
"description": "ISO code, e.g. EUR, USD, CHF; \"XAU\" for gold. Omit for the main currencies."
},
"days": {
"type": "integer",
"minimum": 1,
"maximum": 730,
"description": "History window in days for one currency, default 90."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"datasetId": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": [
"object",
"array",
"null"
]
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"license": {
"type": "string"
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"datasetId",
"title",
"summary",
"url",
"serverDate",
"source",
"license",
"citation",
"docsUrl"
]
}🟢get_fuel_prices(history)
Maximum retail prices of Pb95, Pb98 and diesel in PLN per litre announced by the Minister of Energy in Monitor Polski: price in force, next day price if announced, and recent history.
Eingabe-Schema
{
"type": "object",
"properties": {
"history": {
"type": "integer",
"minimum": 0,
"maximum": 60,
"description": "Number of past announcements, default 7."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"datasetId": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": [
"object",
"array",
"null"
]
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"license": {
"type": "string"
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"datasetId",
"title",
"summary",
"url",
"serverDate",
"source",
"license",
"citation",
"docsUrl"
]
}🟢get_nowcast(indicator, history)
Finwire Nowcast, the finwire.pl statistical model of the next official readings: CPI inflation y/y and core inflation y/y (point and 80% interval) and probabilities of a cut, no change or hike at the next RPP (Monetary Policy Council) meeting. Recomputed daily, frozen 3 working days before publication, then settled against the actual reading; with backtest accuracy vs naive benchmarks. A model estimate, not a consensus and not investment advice.
Eingabe-Schema
{
"type": "object",
"properties": {
"indicator": {
"type": "string",
"enum": [
"cpi",
"core",
"rpp"
],
"description": "One indicator; omit for all three."
},
"history": {
"type": "integer",
"minimum": 0,
"maximum": 24,
"description": "Recent settled or backtest points per indicator, default 6."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"datasetId": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": [
"object",
"array",
"null"
]
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"license": {
"type": "string"
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"datasetId",
"title",
"summary",
"url",
"serverDate",
"source",
"license",
"citation",
"docsUrl"
]
}🟢get_energy_prices(carrier, area, date)
Household electricity and gas tariffs approved by URE and in force today: electricity energy price of the default seller and distribution rates per operator for G11, G12 and G12w with cheaper-zone hours and fees; gas fuel price, subscription and PSG distribution rates per tariff area for W-1.1 to W-4. Net amounts, VAT rate given; each with the URE decision and PDF.
Eingabe-Schema
{
"type": "object",
"properties": {
"carrier": {
"type": "string",
"enum": [
"electricity",
"gas"
],
"description": "Omit for both."
},
"area": {
"type": "string",
"maxLength": 40,
"description": "Filter by distribution operator or gas tariff area, e.g. \"Tauron\", \"Stoen\", \"warszawski\"."
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Day YYYY-MM-DD for which tariffs in force are selected; default today."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"datasetId": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": [
"object",
"array",
"null"
]
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"license": {
"type": "string"
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"datasetId",
"title",
"summary",
"url",
"serverDate",
"source",
"license",
"citation",
"docsUrl"
]
}🟢get_broker_fees(broker, market)
Fees of brokers available to Polish investors from their official fee tables: online order commission on Warsaw (GPW), US and German stocks and ETFs, account and currency conversion fees, IKE/IKZE, investor protection and promotions valid today, with the fee table URL and the date it was last confirmed. Facts only, no ranking or recommendation.
Eingabe-Schema
{
"type": "object",
"properties": {
"broker": {
"type": "string",
"maxLength": 40,
"description": "Filter by broker name or id, e.g. \"XTB\", \"mbank\"."
},
"market": {
"type": "string",
"enum": [
"gpw",
"us",
"de"
],
"description": "Show the commission of one market only."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"datasetId": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": [
"object",
"array",
"null"
]
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"license": {
"type": "string"
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"datasetId",
"title",
"summary",
"url",
"serverDate",
"source",
"license",
"citation",
"docsUrl"
]
}🟢get_housing_prices(city, district, source)
Transaction prices of flats per square meter from notarial deeds (RCN): median, quartiles, year-over-year change and number of deeds in 17 cities, or per district of one city. source "gus" gives the GUS quarterly series instead.
Eingabe-Schema
{
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 48,
"description": "City name or slug (e.g. \"Kraków\" or \"krakow\") for its districts; omit for all cities."
},
"district": {
"type": "string",
"maxLength": 48,
"description": "Filter districts by name, e.g. \"Mokotów\"."
},
"source": {
"type": "string",
"enum": [
"rcn",
"gus"
],
"description": "rcn (default, notarial deeds) or gus."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"datasetId": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": [
"object",
"array",
"null"
]
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"license": {
"type": "string"
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"datasetId",
"title",
"summary",
"url",
"serverDate",
"source",
"license",
"citation",
"docsUrl"
]
}🟢get_rents(city)
Asking rents (median, per m², month-over-month change) in Polish cities and districts, with gross and net rental yield and payback period.
Eingabe-Schema
{
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 48,
"description": "City name or slug (e.g. \"Kraków\" or \"krakow\") for its districts; omit for all cities."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"datasetId": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": [
"object",
"array",
"null"
]
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"license": {
"type": "string"
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"datasetId",
"title",
"summary",
"url",
"serverDate",
"source",
"license",
"citation",
"docsUrl"
]
}🟢get_housing_costs(city)
Monthly running costs of a flat in 20 largest cities: co-op and owners association charges per m², heating, electricity, gas, water and waste rates, each with year and scope (city or province).
Eingabe-Schema
{
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 48,
"description": "City name or slug (e.g. \"Kraków\" or \"krakow\") ; omit for the list of cities."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"datasetId": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": [
"object",
"array",
"null"
]
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"license": {
"type": "string"
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"datasetId",
"title",
"summary",
"url",
"serverDate",
"source",
"license",
"citation",
"docsUrl"
]
}🟢get_credit_market(topic)
Polish housing loan market: topic "index" (finwire 0-100 credit market index), "survey" (NBP bank lending survey: criteria and demand), "monetary" (NBP household loans and deposits, new housing loans).
Eingabe-Schema
{
"type": "object",
"properties": {
"topic": {
"type": "string",
"enum": [
"index",
"survey",
"monetary"
],
"description": "Default index."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"datasetId": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": [
"object",
"array",
"null"
]
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"license": {
"type": "string"
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"datasetId",
"title",
"summary",
"url",
"serverDate",
"source",
"license",
"citation",
"docsUrl"
]
}🟢get_bank_rates(product, amount, period)
Aggregates of offers currently on the market (median and percentiles, no single bank offers): mortgage APRC and margin, cash loan APRC, term deposit and savings account rates; or retail government bond rates (product "bonds").
Eingabe-Schema
{
"type": "object",
"properties": {
"product": {
"type": "string",
"enum": [
"mortgage",
"cash-loan",
"deposit",
"savings",
"bonds"
]
},
"amount": {
"type": "integer",
"minimum": 500,
"maximum": 10000000,
"description": "Model amount in PLN."
},
"period": {
"type": "integer",
"minimum": 0,
"maximum": 120,
"description": "Mortgage: years; cash loan and deposit: months."
}
},
"required": [
"product"
],
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"datasetId": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": [
"object",
"array",
"null"
]
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"license": {
"type": "string"
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"datasetId",
"title",
"summary",
"url",
"serverDate",
"source",
"license",
"citation",
"docsUrl"
]
}🟢get_legal_limits(topic)
Statutory values for the current year: IKE and IKZE contribution limits, PIT thresholds and rates, tax-free amount, capital gains tax, rental flat-rate tax, minimum wage and other limits; topic "local-tax" gives the upper limits of local property tax rates.
Eingabe-Schema
{
"type": "object",
"properties": {
"topic": {
"type": "string",
"enum": [
"limits",
"local-tax"
],
"description": "Default limits."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"datasetId": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": [
"object",
"array",
"null"
]
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"license": {
"type": "string"
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"datasetId",
"title",
"summary",
"url",
"serverDate",
"source",
"license",
"citation",
"docsUrl"
]
}🟢get_legal_changes(topic, days, limit)
Acts of the Journal of Laws and Monitor Polski on personal finance, tax, labour and housing: entering into force soon and recently, with plain-language summaries, plus bills in the Sejm.
Eingabe-Schema
{
"type": "object",
"properties": {
"topic": {
"type": "string",
"maxLength": 40,
"description": "Topic key or word, e.g. \"pit\", \"zus\", \"kredyty\", \"mieszkania\", \"placa_minimalna\"."
},
"days": {
"type": "integer",
"minimum": 7,
"maximum": 365,
"description": "Look-back window for recent acts, default 30."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 30,
"description": "Acts per list, default 8."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"datasetId": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": [
"object",
"array",
"null"
]
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"license": {
"type": "string"
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"datasetId",
"title",
"summary",
"url",
"serverDate",
"source",
"license",
"citation",
"docsUrl"
]
}🟢get_regional_data(topic, level, name, limit)
Regional data: "income" (residents income per capita by municipality, or county with level "powiat"), "unemployment" (registered unemployment by province), "wages" (average wage by province). Filter by name.
Eingabe-Schema
{
"type": "object",
"properties": {
"topic": {
"type": "string",
"enum": [
"income",
"unemployment",
"wages"
]
},
"level": {
"type": "string",
"enum": [
"gmina",
"powiat"
],
"description": "For income, default gmina."
},
"name": {
"type": "string",
"maxLength": 60,
"description": "Name filter, e.g. \"Gdańsk\" or \"pomorskie\"."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Rows per list, default 10."
}
},
"required": [
"topic"
],
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"datasetId": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": [
"object",
"array",
"null"
]
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"license": {
"type": "string"
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"datasetId",
"title",
"summary",
"url",
"serverDate",
"source",
"license",
"citation",
"docsUrl"
]
}🟢get_europe_data(topic)
Poland compared with EU countries: "house-prices" (Eurostat house price index), "mortgage-rates" (ECB rates on new housing loans), "bond-yields" (10-year yields and spreads vs Germany and euro area), "overburden" and "overcrowding" (housing conditions).
Eingabe-Schema
{
"type": "object",
"properties": {
"topic": {
"type": "string",
"enum": [
"house-prices",
"mortgage-rates",
"bond-yields",
"overburden",
"overcrowding"
]
}
},
"required": [
"topic"
],
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"datasetId": {
"type": "string"
},
"title": {
"type": "string"
},
"summary": {
"type": "array",
"items": {
"type": "string"
}
},
"data": {
"type": [
"object",
"array",
"null"
]
},
"truncated": {
"type": "boolean"
},
"url": {
"type": "string"
},
"serverDate": {
"type": "string"
},
"asOf": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"license": {
"type": "string"
},
"citation": {
"type": "string"
},
"docsUrl": {
"type": "string"
}
},
"required": [
"datasetId",
"title",
"summary",
"url",
"serverDate",
"source",
"license",
"citation",
"docsUrl"
]
}Community
Nachweis