finwire.pl - Polish financial data

pl.finwire由 finwire.pl 发布官方发布者v1.14.0更新于 Nov 7, 2026

Live Polish rates, FX, housing prices, rents, credit market, legal limits and macro data.

已验证Streamable HTTP可网页运行位置与生活金融数据与分析

概览

AI 生成的概览

只读 MCP 服务器,让助手获取波兰实时金融与宏观经济数据:NBP 利率、汇率、通胀、房价、租金、信贷市场与法定限额。

可以做什么
  • 获取宏观快照,列出、读取并对比指标,查看近期变化与发布日历
  • 读取 NBP 政策利率、汇率与黄金、燃油上限价、受管制电力和燃气费率及零售物价
  • 查询住房:每平方米成交价、租金与收益率、持有成本、供给与居住成本
  • 查阅养老金、公共债务、投资基金、IKE/IKZE、PPK、零售债券、券商费用与家庭固定支出负担
  • 查看 finwire 指数、即时预测与领先预测,以及企业注册、车辆和电动车充电统计
  • 搜索数据集目录并按 id 获取任意数据集
适用场景
适合回答有关波兰经济、个人理财、房贷、住房或储蓄的问题,或需要波兰指标简报与对比时使用。也适用于需要引用波兰官方来源的研究、新闻图表与分析。
运行要求
远程 Streamable HTTP 端点;无需 API 密钥、注册或环境变量。需要能访问 finwire 公共 API 的网络。只读访问。
安装前请注意
所有工具均为只读,但数据仅供参考,部分数值为模型估计或预测(即时预测、领先预测、次年限额),应注明其性质。暂定日历日期和初步季度数据可能变动。不提供 WIBOR 和 POLSTR。数据许可要求注明 finwire.pl 及原始来源。

安装

在 SourceWeft 中

  1. 打开 控制台中的 finwire.pl - Polish financial data,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/pl.finwire%2Fdata/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "finwire-pl-polish-financial-data": {
      "type": "http",
      "url": "https://public-api.finwire.pl/mcp"
    }
  }
}

README

finwire API - free Polish financial data API (NBP, GUS, RCN)

finwire API is a free, open REST API with financial, labour market and real estate data for Poland: NBP policy rates, CPI inflation, NBP exchange rates, 10-year government bond yields, flat transaction prices from notarial deeds, rents, housing supply, wages by occupation, unemployment by province and county, and an economic calendar. No API key, JSON over HTTPS, OpenAPI 3 specification, every response with its primary source and a ready-to-paste citation. Built and maintained by finwire.pl.

[Docs] [OpenAPI] [Data license]

bash
curl "https://public-api.finwire.pl/v1/series/interest-rate/stopa-referencyjna?days=90"
  • Base URL: https://public-api.finwire.pl
  • Auth: none - no key, no sign-up, GET only, CORS enabled (works from the browser)
  • Format: JSON, UTF-8, { data, meta } envelope
  • Specification: openapi.json · interactive reference · llms.txt · dataset pages
  • Data license: CC BY 4.0 for finwire indicators and aggregates; public data requires attribution to the original source; the license of each dataset is in its license field
  • WIBOR and POLSTR: not available. They are GPW Benchmark data; redistribution requires a Market Data License Agreement with GPW (gpwbenchmark.pl)
  • Changes: CHANGELOG.md

Po polsku: darmowe API z polskimi danymi finansowymi - stopy NBP, inflacja CPI (GUS), kursy walut NBP, rentowności obligacji, ceny transakcyjne mieszkań z Rejestru Cen Nieruchomości, czynsze i rentowność najmu, podaż mieszkań, wynagrodzenia GUS (także według zawodów), bezrobocie w województwach i powiatach, próg wejścia (ile trzeba zarabiać na kredyt na mieszkanie), limity podatku od nieruchomości, kalendarz odczytów makro. Bez klucza i rejestracji. Opis po polsku: finwire.pl/otwarte-api.


Contents


Data coverage

Every dataset comes from its primary source and is served in one format, with that source in meta.

Each dataset name links to its documentation page with fields, source and citation.

DataEndpointPrimary sourceFrequencyHistory
NBP policy rates (reference, lombard, deposit, rediscount, discount)/v1/series/interest-rate/{id}NBPon MPC decisionsup to 10 years
CPI inflation (YoY, MoM)/v1/series/cpiGUSmonthlysince 1982
NBP exchange rates (table A mid, table C bid/ask)/v1/series/fx/{code}NBPdaily (business days)up to 10 years
10-year government bond yields: PL, DE, euro area, EU + spreads/v1/series/bond-yields/{geo}Eurostat irt_lt_mcby_mmonthlysince 2001
Retail government bonds (OTS, ROR, DOR, TOS, COI, EDO, ROS, ROD)/v1/bondsMinistry of Financemonthly issuescurrent issues
Flat transaction prices per m² (median, quartiles, primary/secondary) - 17 cities and their districts/v1/housing/transactions/{city}Real Estate Price Register (RCN, GUGiK + city registers)quarterly, ingested dailylast 12 quarters per city
Housing prices per m² in 17 cities/v1/series/housing/{city}GUSquarterlylatest quarters
Housing supply: dwellings per 1000, completions, permits, migration/v1/housing/supply/{city}GUS BDL, Census 2021yearlysince 2010
Asking rents per city and district/v1/rent/{city}znajdznajem.pldaily snapshotcurrent + previous month
Rental yield (gross, net, payback)/v1/rent/yieldfinwire.pl (rents + RCN prices)dailycurrent
Wages: median, percentiles, 16 provinces/v1/wagesGUSon GUS releasecurrent
Wages by occupation: mean, median, deciles, gender gap - about 175 groups/v1/wages/occupations/{code}GUSevery 2 yearssurvey editions
Registered unemployment: Poland, 16 provinces, highest/lowest counties/v1/series/unemploymentGUS BDLmonthlysince 2011
Macroeconomic indicators: GDP, retail sales, output, CPI, unemployment, wages, FX, credit, limits/v1/macro/indicatorsGUS, NBP, Eurostat, Ministry of Financeon releasefull history per indicator
Consumer sentiment: BWUK, WWUK and 13 components/v1/macro/consumer-sentimentGUSmonthlysince 2010
Average wage, enterprise sector by province/v1/wages/enterpriseGUSmonthly2 years
Gold price (1 g, fineness 1000)/v1/series/goldNBPdaily (business days)since 2013
Maximum fuel prices: Pb95, Pb98, diesel/v1/fuel-pricesMinister of Energy (Monitor Polski)on announcementall announcements
Retail prices in shops: 30 goods and services, finwire shopping basket, minutes of work/v1/prices/retailGUS (Dziedzinowa Baza Wiedzy)monthlyfrom 2018
Business registrations: new, closed, suspended and resumed sole proprietorships in CEIDG, share of women, finwire_new_business_ratio/v1/business-registrationsMRiT (dane.gov.pl)monthlyfrom November 2019
Vehicle registrations: first registrations by vehicle type and province, passenger-car brands, share of brands from China, finwire_car_registrations_pulse, finwire_chinese_brands_share/v1/vehicle-registrationsMinistry of Digital Affairs (CEPiK data, dane.gov.pl)monthlyfrom January 2014, brands from January 2023
Electric cars: BEV and PHEV fleet and new cars, fuel mix of new cars, counties and provinces, charging vs EV correlation, finwire_ev_share_new_cars/v1/electric-vehiclesEurostat, GUS BDL, UDT EIPAyearlyEurostat from 2013
EV charging points: locations, stations and points, fast sites by province and county, finwire_ev_charging_coverage/v1/ev-chargingUDT EIPAmonthly (month ends), daily current statefrom December 2019
IKE and IKZE retirement accounts: accounts, assets and contributions by institution type, limit usage, finwire_ike_ikze_avg_balance/v1/ike-ikzeKNFhalf-yearlyfrom June 2020
Investment funds: assets and net flows of the market, fund groups, PPK, bond types, equity regions, finwire_fund_flows_index/v1/investment-fundsIZFiAmonthlymarket from February 2020, groups from February 2022
Czyste Powietrze subsidy programme: applications, contracts, payouts, payout queue, heat sources, finwire_clean_air_payout_rate/v1/subsidies/clean-airNFOŚiGWweeklyfrom February 2024 (archived readings)
Average ZUS pension: gross and net, other pensions, allowances, finwire_pension_wage_ratio/v1/pensionsZUS, GUSmonthly (preliminary data)from December 2023
Average Pole (finwire_average_pole): median age, median wage, flat price, average mortgage and model payment, pension, spending, car age, top car brand/v1/average-poleEurostat, GUS, BIK, NBP, ZUS, Ministry of Digital Affairseach trait on its source's release (annual to monthly)latest readings
PPK (Employee Capital Plans): net assets, active accounts, participants, participation rate, average fee, finwire_ppk_avg_account/v1/ppkPFR Portal PPK (monthly bulletin)monthlyfrom October 2021
Retail savings bonds vs bank deposits: first-year bond rates minus best deposits, savings accounts and average new deposit after tax, finwire_retail_bond_premium/v1/retail-bond-premiumMinistry of Finance, NBP, finwire.pl deposit indicesmonthlyfrom the first month with both bond issue and deposit data
Household fixed cost burden: mortgage, admin fee, utilities and TV licence as % of net income, Poland and 16 provinces, finwire_fixed_cost_burden/v1/fixed-cost-burdenGUS, NBP, KRRiTmonthlylast 36 months with complete inputs
Heating season: degree days since 1 July vs the 20-season norm, cold index, season cost of a 100 m2 house, Poland and 17 cities, finwire_heating_season_index, finwire_heating_season_cost/v1/heating-seasonIMGW-PIB, Eurostat, URE, GUSdailyseasons since 1966/67
Polish public debt and state budget: State Treasury debt, debt per resident finwire_public_debt_per_capita, public debt % of GDP, budget deficit/v1/public-debtMinistry of Finance, GUS, Eurostatmonthly (debt), quarterly (% of GDP), monthly (budget estimate)debt from January 2001, budget from 2018
PIT returns by municipality: PIT due per resident finwire_pit_per_capita, by type of return (PIT-37, PIT-36L, PIT-28, PIT-38), every municipality and province/v1/pit/summary, /v1/pit/municipalities, /v1/pit/municipalities/{teryt}Ministry of Finance, GUSyearlytax years from 2022
Regulated electricity and gas prices: household tariffs G11, G12, G12w and W-1.1 to W-4/v1/energy/regulated-pricesPresident of URE (tariff decisions)on new decisiontariff years in force
Brokerage account fees: commissions on GPW, US and German stocks, account and FX fees/v1/brokersbrokers' official fee tables, compiled by finwire.plweekly checkcurrent fee tables
Legal changes radar: acts entering into force, bills in the Sejm/v1/legal-changesSejm ELI APIdailyupcoming and recent
Residents income by municipality and county/v1/income/municipalitiesMinistry of Finance (Rb-27S), GUS BDL, computed by finwire.plyearly, quarterly updatebudget years
Housing running costs in 20 cities/v1/housing/upkeep/{city}GUS BDLyearlylatest year
House prices and housing conditions in Europe/v1/housing/europeEurostatquarterly, yearlysince 2010 (conditions)
Bank lending survey/v1/credit-market/surveyNBPquarterlyeditions
Household loans and deposits/v1/credit-market/monetaryNBPmonthlyup to 400 months
Housing loan demand (BIK)/v1/credit-market/demandBIK, NBPmonthlyfrom 2025-08
Mortgage payment risk and fixed-rate premium: chance the variable-rate payment rises by more than 5% in 12 months, payment percentiles in 3, 6 and 12 months, backtest accuracy, finwire_rate_risk_gauge, finwire_fixed_rate_premium/v1/credit-market/rate-riskfinwire.pl model on GPW Benchmark WIBOR (result only), bank offers, ECB MIRdailymonth ends from 2008
Interest rates on new loans in Europe/v1/credit-market/ecb-ratesECB MIRmonthlysince 2014
Electricity and gas prices for households in the EU: EUR, PPS, PLN, finwire_eu_power_price_gap, kWh per minimum wage/v1/europe/energy-pricesEurostat (nrg_pc_204, nrg_pc_202)half-yearlysince 2007
Minimum wages in the EU: EUR, PPS, national currency/v1/europe/minimum-wagesEurostat (earn_mw_cur)half-yearlysince 1999
Economic calendar: MPC (RPP) decisions, CPI, wages, GDP, unemployment/v1/calendarGUS, NBP, compiled by finwire.plcontinuousupcoming events
IKE / IKZE contribution limits/v1/legal-limitsMinistry of Family announcementsyearlycurrent year
Property tax upper limits/v1/legal-limits/local-taxMinister of Finance (Monitor Polski)yearlyannounced tax years
Deposit, savings, mortgage and cash loan rate aggregates/v1/market/*finwire.pl (aggregate of offers on the market)dailycurrent
finwire index registry: every index computed by finwire.pl under a stable finwire_* id (list)/v1/finwire-index/{id}finwire.pl (method and sources per index)daily, monthly or quarterly per indexper index
Legal calendar (finwire_legal_calendar): PIT, ZUS and VAT deadlines, IKE/IKZE year end, changes of statutory values, acts entering into force, RPP meetings, retail bond sales/v1/legal-calendarSejm ELI API, NBP, Ministry of Finance, statutory deadlines, compiled by finwire.pldailyupcoming events, ICS at finwire.pl/kalendarz-zmian.ics
KNF public warnings: entries verbatim from KNF, counts by legal basis, entity lookup, weekly new entries (finwire_knf_warnings_monitor)/v1/knf-warningsKNF, lista ostrzeżeń publicznych3 times a daycurrent list, weekly series since November 2026
BFG deposit guarantee list: banks and credit unions covered by the BFG guarantee, counts by group with history (finwire_bfg_guarantee_monitor), latest changes, lookup by name or website/v1/bfg-guaranteeBFG, lista podmiotów objętych gwarancjamitwice a dayevery change of the list since 2019
Court rulings in credit disputes: rulings of common courts on CHF and other currency mortgages, WIBOR, free credit sanction, early repayment refunds and unit-linked policies, monthly counts, share for the borrower (finwire_borrower_win_share), instances, newest rulings with links/v1/credit-judgmentsCourt Rulings Portal, Ministry of Justice via SAOSdailyall published rulings, history filled over the first weeks
Tax rulings: KIS and municipal individual rulings by personal finance topic, weekly counts (finwire_tax_rulings_pulse), most cited provisions, newest rulings with links/v1/tax-rulingsMinistry of Finance, EUREKAdailylast 53 weeks, growing
Next-year statutory limits (finwire_next_year_limits): pension indexation, minimum wage, IKE/IKZE limits, ZUS caps and bases, flat-rate tax and small CIT taxpayer limits for the next year from the formulas in law, with stage, 80% interval and backtest/v1/legal-limits/next-yearfinwire.pl calculation from GUS and NBP data and acts in the Journal of Laws and Monitor Polskiseveral times a daynext year, estimate path since June, backtest on past years
Entry threshold: wage needed for a mortgage on a model flat, 17 cities/v1/index/entry-thresholdfinwire.pl (prices from notarial deeds in RCN, GUS RCiWN fallback, mortgage offers, GUS wage distribution)dailysince September 2026
Finwire Nowcast: forecasts of CPI and core inflation and the RPP decision/v1/macro/nowcastfinwire.pl model (inputs: GUS, NBP, EC Oil Bulletin)daily, frozen 3 working days before publicationbacktest since 2019 (CPI, core), 2012 (RPP)
finwire lead forecasts: core inflation in 6-12 months and impaired loans in 2-4 quarters/v1/macro/lead-forecastsfinwire.pl models (inputs: GUS, NBP, Eurostat, KNF)daily model run, monthly datarolling backtest, published only above 70% interval coverage
finwire indicators: credit stress map, barometers/v1/index/*finwire.pl (computed from the above)daily (credit stress), monthly (barometers)barometers since 2015

Aggregates never expose single offers, deeds or listings - only medians, percentiles and counts.


Use cases

  • Mortgage and savings calculators - NBP reference rate and market median mortgage rates in one call (/v1/snapshot).
  • Newsroom and research charts - CPI since 1982, unemployment since 2011, bond yields since 2001, with a ready citation in meta.
  • Real estate analysis - transaction prices per district, rents, rental yield and housing supply for 17 cities.
  • Labour market and HR - wages by occupation with deciles and the gender pay gap, unemployment by county.
  • Personal finance apps - IKE/IKZE limits, retail bond rates, deposit and savings rate medians.
  • AI assistants and agents - an MCP server (Streamable HTTP, no key) serves rates, FX, housing prices, rents, the credit market, legal limits, law changes and macro data to Claude, ChatGPT, Cursor, VS Code and other MCP clients; llms.txt and the OpenAPI spec describe every dataset in machine-readable form.

Quick start

curl

bash
# Current table of NBP policy ratescurl "https://public-api.finwire.pl/v1/series/interest-rate"
# Median flat transaction price per m² by district in Krakówcurl "https://public-api.finwire.pl/v1/housing/transactions/krakow"
# Next 10 macro releases and MPC decisionscurl "https://public-api.finwire.pl/v1/calendar?limit=10"

JavaScript / TypeScript (browser or Node 18+)

ts
const res = await fetch('https://public-api.finwire.pl/v1/series/interest-rate/stopa-referencyjna?days=365');const { data, meta } = await res.json();console.log(data.points.at(-1), meta.citation);

Python

python
import requests
r = requests.get("https://public-api.finwire.pl/v1/series/cpi", params={"type": "monthly", "limit": 24})payload = r.json()for row in payload["data"]["entries"]:    print(row["period"], row["yoy"])print(payload["meta"]["citation"])

MCP server for AI assistants

https://public-api.finwire.pl/mcp - Model Context Protocol over Streamable HTTP, stateless, no key, read-only. The same data, whitelist and licenses as /v1. What it answers, with a coverage table and example questions: finwire.pl/en/mcp (Polish: finwire.pl/mcp).

ClientHow to connect
Claude (claude.ai, Desktop)Settings - Connectors - Add custom connector - URL https://public-api.finwire.pl/mcp
Claude Codeclaude mcp add --transport http finwire https://public-api.finwire.pl/mcp
ChatGPTConnectors in developer mode - create a connector with the URL above, no authentication
Cursor~/.cursor/mcp.json: {"mcpServers": {"finwire": {"url": "https://public-api.finwire.pl/mcp"}}}
VS Code.vscode/mcp.json: {"servers": {"finwire": {"type": "http", "url": "https://public-api.finwire.pl/mcp"}}}

Tools (all read-only, each with outputSchema):

  • Macro: get_macro_snapshot, list_macro_indicators, get_macro_indicator, compare_macro_indicators, get_macro_changes, get_macro_calendar
  • Rates and prices: get_interest_rates (NBP), get_currency_rates (NBP FX, gold), get_fuel_prices, get_energy_prices (URE electricity and gas tariffs), get_retail_prices (GUS shop prices, finwire shopping basket)
  • Subsidies: get_subsidy_stats (Czyste Powietrze heating subsidy programme: applications, contracts, payouts, payout queue, finwire_clean_air_payout_rate)
  • Pensions: get_pension_stats (average ZUS pension gross and net, other pensions, allowances, finwire_pension_wage_ratio)
  • Typical person: get_average_pole (Average Pole finwire_average_pole: median age, wage, flat, mortgage and model payment, pension, spending, car age, top brand; each trait with measure and period)
  • Businesses: get_business_registrations (applications in CEIDG to register, close, suspend and resume a sole proprietorship, finwire_new_business_ratio)
  • Cars: get_vehicle_registrations (first registrations by type, province and passenger-car brand, share of brands from China, finwire_car_registrations_pulse, finwire_chinese_brands_share), get_electric_vehicles (BEV and PHEV fleet and new cars, counties, charging vs EV correlation, finwire_ev_share_new_cars), get_ev_charging (EIPA charging points, fast sites, finwire_ev_charging_coverage, AFIR power classes with median prices), find_ev_chargers (chargers near a city or point: power, free now, price per kWh, one site card), growth of charging infrastructure in get_ev_charging (finwire_ev_infrastructure_growth), get_ev_charging_prices (price per kWh by power class and network, price changes, finwire_ev_charging_price_index)
  • PPK: get_ppk_stats (Employee Capital Plans from the PFR Portal PPK bulletin: net assets, active accounts, participants, participation rate, average fee, finwire_ppk_avg_account)
  • Retail bonds vs deposits: get_retail_bond_premium (first-year premium of each retail savings bond series over the best deposits, savings accounts and the average new deposit after tax, retail bond sales, finwire_retail_bond_premium)
  • Household budget: get_fixed_cost_burden (share of net income taken by mortgage, admin fee, utilities and TV licence, Poland and 16 provinces, finwire_fixed_cost_burden)
  • Heating season: get_heating_season (degree days vs norm, cold index, season forecast and heating cost of a 100 m2 house, Poland and 17 cities, finwire_heating_season_index, finwire_heating_season_cost)
  • Investment funds: get_investment_funds (IZFiA assets, inflows, outflows and net flows by fund group, PPK, finwire_fund_flows_index)
  • IKE and IKZE: get_ike_ikze_stats (KNF half-yearly accounts, assets and contributions by institution type, limit usage, finwire_ike_ikze_avg_balance)
  • Public debt: get_public_debt (State Treasury debt, debt per resident finwire_public_debt_per_capita, public debt % of GDP, state budget deficit)
  • finwire indices: list_finwire_indices (all finwire_* ids with the latest reading), get_finwire_index (one index by id or alias, with history and citation)
  • Forecasts: get_nowcast (Finwire Nowcast: CPI and core inflation, RPP decision probabilities, accuracy)
  • Lead forecasts: get_lead_forecasts (core inflation in 6-12 months finwire_cost_pressure, impaired housing and consumer loans in 2-4 quarters finwire_npl_forecast; shown only above the accuracy threshold)
  • Housing: get_housing_prices (notarial deeds, cities and districts), get_rents (rents, rental yield), get_housing_costs, get_housing_balance (finwire_housing_pressure new residents per new dwelling, finwire_housing_pipeline completions forecast from building permits, finwire_rent_forecast 6-month rent forecast)
  • Credit, savings and investing: get_credit_market, get_rate_risk (mortgage payment risk in 3, 6 and 12 months with backtest, finwire_rate_risk_gauge; fixed-rate premium finwire_fixed_rate_premium), get_bank_rates (aggregates only, no single offers; retail bonds), get_broker_fees (brokerage fee tables)
  • Law: get_legal_limits (IKE/IKZE, PIT, minimum wage, local tax limits), get_next_year_limits (next-year statutory values from legal formulas before the act, finwire_next_year_limits), get_legal_changes (acts, bills in the Sejm and the next 30 days of finwire_legal_calendar), get_tax_rulings (tax rulings by personal finance topic), check_knf_warnings (a firm or website on the KNF public warnings list), check_bfg_guarantee (a bank or credit union on the BFG deposit guarantee list)
  • Business in Poland (also for founders from abroad): plan_business_entry (forms available to the owner with reasons, taxes and net per form with the treaty dividend rate, setup steps, residence, deadlines), get_business_forms, calc_net_income (employment, mandate, work contract, B2B), compare_business_forms (JDG vs sp. z o.o.), calc_employer_cost, calc_zus_contributions, get_tax_treaty (withholding tax, treaty rates), get_compliance_calendar, get_business_guide (verified facts with legal basis), get_business_glossary
  • Regions and Europe: get_regional_data (income and PIT per resident by municipality, unemployment, wages), get_europe_data (house prices, mortgage rates, bond yields, household electricity and gas prices, minimum wages in the EU)
  • Any dataset: search_datasets, get_dataset

Every result carries the period of the data, the original source, license, a ready citation and url - the finwire.pl page with the full table, chart and calculator (with utm_source=mcp). Resources: macro://catalog, finwire://datasets, finwire://dataset/{id}; prompts: macro_briefing, explain_indicator, city_housing_report, personal_finance_limits.

Discovery: server card (application/mcp-server-card+json), /.well-known/ard.json, registry manifest server.json.


Response format and citation

Every response uses the same envelope. Values below are illustrative - call the endpoint for current data.

json
{  "data": { "...": "dataset-specific payload" },  "meta": {    "datasetId": "interest-rates",    "source": "NBP, GPW Benchmark",    "sourceUrl": "https://nbp.pl",    "license": "Public NBP / GPW Benchmark data - attribution required.",    "asOf": "2026-10-14",    "fetchedAt": "2026-10-15T08:00:00.000Z",    "citation": "Source: finwire.pl (NBP, GPW Benchmark), https://public-api.finwire.pl/datasets/interest-rates",    "docsUrl": "https://public-api.finwire.pl/datasets/interest-rates"  }}
  • meta.asOf - the date of the data at the source (not the time of your request).
  • meta.citation - a ready-to-use attribution string with a link. Use it as is.

How to cite: Source: finwire.pl (<primary source>), https://public-api.finwire.pl/datasets/<dataset-id>

CodeMeaning
200OK
404Unknown dataset, indicator, city or geo code
429Rate limit exceeded (see Retry-After)
503Primary source temporarily unavailable

Endpoints

Interest rates, inflation, FX, bond yields, unemployment

EndpointReturns
GET /v1/series/interest-rateCurrent table of NBP policy rates
GET /v1/series/interest-rate/{id}?days=365Daily history. id: stopa-referencyjna, stopa-lombardowa, stopa-depozytowa, stopa-redyskontowa, stopa-dyskontowa. days: 7-3650
GET /v1/series/cpi?type=monthly&limit=24CPI YoY and MoM. type: monthly or yearly, limit: 1-600
GET /v1/series/fxCurrent NBP FX table
GET /v1/series/fx/{code}?days=365FX history, e.g. EUR, USD, CHF, GBP
GET /v1/series/bond-yieldsLatest 10-year yields for PL, DE, EA, EU27_2020, PL-DE and PL-EA spreads in bps
GET /v1/series/bond-yields/{geo}?since=2015-01Monthly history for one geo
GET /v1/series/unemploymentRegistered unemployment rate: Poland and 16 provinces, latest month, YoY change in pp
GET /v1/series/unemployment/counties?limit=10Counties (powiaty) with the lowest and highest rate, limit 1-50
GET /v1/series/unemployment/history?unit={unitId}Monthly history since 2011 for Poland (default) or a province (unitId from regions[])

Real estate

EndpointReturns
GET /v1/housing/transactions17 cities: median, p25, p75 price per m² from notarial deeds, primary vs secondary market, transaction count, YoY, quarterly trend
GET /v1/housing/transactions/{city}Districts of a city: 12-month median price per m², transaction count, YoY, difference vs city median
GET /v1/housing/location-premium/{city}Districts of a city: actual vs expected price per m² from neighbourhood quality, premium %, model fit (finwire_location_premium)
GET /v1/local-tax-squeezeProperty tax as % of property tax + PIT share in municipal budgets: Poland, provinces, cities, municipalities in the squeeze (finwire_local_tax_squeeze); /municipalities for every municipality
GET /v1/jst-budget/municipalitiesMunicipal budgets: spending, debt and EU funding per resident of every municipality (finwire_gmina_spending_per_capita); /municipalities/{teryt} for one municipality by category vs neighbours, similar municipalities and Poland; /ranking by metric
GET /v1/series/housing and /{city}GUS housing prices per m² for 17 cities, latest quarters, nominal and real YoY
GET /v1/rent and /{city}Asking rents: median, mean, per m², month-over-month change, districts
GET /v1/rent/yieldGross and net rental yield and payback period per city
GET /v1/housing/carryHousing carry per city: net rental yield minus mortgage rate, monthly (finwire_housing_carry)
GET /v1/housing/supplyDwellings per 1000 residents, stock, completions, permits, floor area per person, population and migration: Poland, 16 provinces, 17 cities, yearly since 2010, Census 2021, GUS population forecast
GET /v1/housing/supply/{city}One city vs its province and Poland, rank among 17 cities, yearly history

provisionalQuarters in transaction data lists quarters the registry is still filling in - treat them as preliminary.

Wages, legal limits, calendar, market aggregates

EndpointReturns
GET /v1/bondsRetail government bond rates by issue
GET /v1/wagesGUS wage median, percentiles and provincial averages
GET /v1/wages/occupationsGross wages for about 175 occupation groups: mean, median, deciles D1-D9, men vs women, public vs private, gender pay gap
GET /v1/wages/occupations/{code}One occupation group with its parent groups and survey edition history
GET /v1/legal-limitsIKE / IKZE annual contribution limits and related values
GET /v1/legal-limits/local-taxUpper limits of property tax rates (land, buildings, structures) per tax year, with the act and legal basis
GET /v1/legal-limits/next-year?path=falseNext-year statutory values from the formulas in law (finwire_next_year_limits): value, 80% interval, stage (projekcja, projekt, obwieszczenie, obowiazuje), calculation, inputs, estimate path and backtest
GET /v1/macro/indicatorsHeadline indicators with the latest reading, change, sparkline and source
GET /v1/macro/indicators/{key}/history?from=2020-01Full history of one indicator
GET /v1/macro/consumer-sentimentGUS BWUK, WWUK and components with the history
GET /v1/wages/enterpriseGUS average wage in the enterprise sector, real change, by province
GET /v1/series/goldNBP gold price: latest, period changes, all-time high, 12-month average
GET /v1/series/gold/history?range=1yGold price history, range: 1m, 1y, 5y, max
GET /v1/fuel-pricesMaximum fuel prices: in force today, announced for tomorrow, history
GET /v1/prices/retailAverage retail prices of 30 goods and services (GUS), changes, minutes of work, finwire shopping basket; ?product= for one price history
GET /v1/subsidies/clean-airCzyste Powietrze programme (NFOŚiGW): applications, contracts and payouts cumulative, Modernisation Fund edition, last week, payout queue and pace, heat sources, reading history
GET /v1/pensionsAverage ZUS pension gross and net, other pensions, allowances, pension to wage ratio, monthly history
GET /v1/average-poleAverage Pole (finwire_average_pole): traits of the typical person in Poland with measure (median, mean, model, distribution, mode), period and source
GET /v1/business-registrations?months=24Applications filed in CEIDG (MRiT): registrations, closures, suspensions and resumptions of sole proprietorships, net, same month in earlier years, share of women, finwire_new_business_ratio, monthly history
GET /v1/vehicle-registrations?months=24&province=14First registrations in Poland (Ministry of Digital Affairs, CEPiK data): passenger cars and all vehicles, 17 types, provinces per 1000 residents, held-back months, brands of the month and 12 months, share of brands from China, finwire_car_registrations_pulse, finwire_chinese_brands_share
GET /v1/electric-vehicles?counties=allBEV and PHEV passenger cars: fleet and new cars by year (Eurostat), fuel mix of new cars, provinces and counties per 1000 cars (GUS BDL), top and bottom counties, correlation of charging sites and EVs with a version controlling wages, finwire_ev_share_new_cars
GET /v1/ev-charging/chargers?city=Łódź&minKw=150EV charging sites (UDT EIPA, end-user data account) by city or point and radius: power class, kW, points free now, lowest ad hoc price per kWh; /v1/ev-charging/chargers/{id} = one site with points, connectors, prices and status
GET /v1/ev-charging/pricesAd hoc charging prices per kWh by AFIR power class, AC vs DC, networks, cities, recent changes, finwire_ev_charging_price_index
GET /v1/ev-charging/networksCharging networks: stations, points, median prices, reliability, ranking with weights; /v1/ev-charging/networks/{slug} = one network price list, finwire_ev_charger_reliability
GET /v1/ev-charging/occupancyCharger occupancy now, weekly trend and by weekday x hour, busiest sites, cities and networks, finwire_ev_charger_occupancy (full weeks, after 14 days of readings)
GET /v1/ev-charging/growth?network=greenwayGrowth of charging infrastructure: EIPA month ends since December 2019 with monthly change, year on year and records, CNG/LNG; daily sites and points by power class, province and network (or one network / city), finwire_ev_infrastructure_growth
GET /v1/ev-charging/coverage?counties=allDistance from each county to the nearest charging site from 150 kW, finwire_ev_fast_coverage
GET /v1/ev-charging/gasCNG, LNG and hydrogen stations with prices per m3 or kg
GET /v1/ev-charging?months=24Public EV charging (UDT EIPA): points, stations and locations today and at month ends since December 2019, sites and fast sites by province and county, finwire_ev_charging_coverage
GET /v1/ppk?months=12PPK (Employee Capital Plans) from the monthly PFR Portal PPK bulletin: net assets, active accounts, participants, employers, participation rate, average fee, finwire_ppk_avg_account, monthly history
GET /v1/retail-bond-premium?months=12Premia obligacji skarbowych finwire: retail savings bonds vs the finwire deposit and savings indices and the NBP average new deposit, after tax, per series, retail bond debt change, sales response test
GET /v1/fixed-cost-burden?region=mazowieckieSztywne koszty gospodarstwa finwire: share of household net income taken by fixed costs, Poland and 16 provinces, components in PLN, monthly history
GET /v1/ike-ikzeIKE and IKZE (KNF, half-yearly): accounts, assets, contributions, withdrawals and returns by institution type, holders by sex and age, average contribution vs annual limit, finwire_ike_ikze_avg_balance, history in PLN
GET /v1/investment-funds?months=24Investment funds (IZFiA): assets, purchases, redemptions and net flows of the market and fund groups, bond types, equity regions, finwire_fund_flows_index, monthly history in PLN million
GET /v1/public-debtState Treasury debt monthly since 2001, debt per resident, growth per second, structure, public debt % of GDP, budget deficit with plan
GET /v1/energy/regulated-prices?date=2026-10-29Household electricity and gas tariffs approved by URE in force on a day (default today): energy and distribution rates, fees, cheaper-zone hours, decision and PDF per row; net amounts
GET /v1/brokersBroker fee tables: commissions by market, account and FX fees, IKE/IKZE, active promotions, fee table URL and weekly check status
GET /v1/legal-changes?days=90Acts entering into force soon and recently, open bills in the Sejm
GET /v1/legal-changes/process/{term}/{number}One bill: last stage, passage, published act
GET /v1/legal-calendar?kategorie=przepisy,wartosci&od=2026-11-01&do=2027-03-31Legal calendar finwire_legal_calendar: dated events with category, legal basis, source and finwire.pl page, the number of changes in acts and values in the next 30 days. kategorie: przepisy, wartosci, podatki, firma, oszczednosci, obligacje, stopy
GET /v1/knf-warningsKNF public warnings list: entries by legal basis, prosecutors, new entries per full week (finwire_knf_warnings_monitor), newest entries verbatim from KNF
GET /v1/bfg-guaranteeBFG deposit guarantee list: counts of banks and credit unions with history (finwire_bfg_guarantee_monitor), latest changes, EUR limit and its PLN equivalent; /search?q= looks up an entity
GET /v1/credit-judgments?category=wiborCourt rulings in WIBOR disputes: monthly counts, share ruled for the borrower at least in part (finwire_borrower_win_share), instance I vs II, newest rulings with case number, court, outcome and Court Rulings Portal link
GET /v1/tax-rulings?topic=najem_prywatnyTax rulings on a personal finance topic: weekly counts (finwire_tax_rulings_pulse), most cited provisions, newest rulings with signature, authority, shortened thesis and EUREKA link
GET /v1/knf-warnings/search?q=tradereu.comLook up a firm by name, website, KRS, NIP or REGON; onList: false does not mean the firm holds a KNF licence
GET /v1/income/municipalities?year=2025Residents income per capita by municipality: rank, ratio to the national average, change
GET /v1/income/counties?year=2025The same by county
GET /v1/housing/upkeep/{city}Monthly running costs of a flat in a city (list: /v1/housing/upkeep)
GET /v1/housing/europeEurostat house price index: Poland vs EU vs euro area and country ranking
GET /v1/housing/europe/overburden and /overcrowdingHousing cost overburden and overcrowding rates by country
GET /v1/europe/energy-prices?product=electricity&compare=DEHousehold electricity or gas prices per kWh in EU countries (Eurostat, half-yearly): ranking in EUR and PPS, Poland in PLN, EU average, history since 2007, finwire_eu_power_price_gap, kWh per monthly minimum wage
GET /v1/europe/minimum-wages?compare=DEMonthly statutory minimum wages in EU countries (Eurostat, half-yearly): ranking in EUR and PPS, medians, history of Poland and a comparison country
GET /v1/credit-market/survey?quarters=12NBP bank lending survey
GET /v1/credit-market/monetary?months=25NBP household loans, deposits and new loans
GET /v1/credit-market/demand?months=12BIK housing loan demand, requested vs granted amount, granted loans (BIK) and new housing loans (NBP)
GET /v1/credit-market/rate-risk?days=30Ryzyko raty finwire (chance the payment rises by more than 5% or 10% in 3, 6 and 12 months, payment percentiles, backtest since 2008) and Premia za stałą stopę finwire (5-year fixed minus expected variable cost, daily and monthly from ECB MIR, negative premium windows)
GET /v1/credit-market/ecb-rates?product=mortgage_total&period=2026-08ECB MIR rate on new loans by country
GET /v1/credit-market/ecb-rates/series?areas=PL,U2,DE&from=2018-01ECB MIR history for selected countries
GET /v1/calendar?limit=10Upcoming releases and decisions with date, Warsaw time, category, importance 1-10
GET /v1/market/deposit-rates?amount=10000&period=3Term deposit rates: median, percentiles, spread
GET /v1/market/savings-rates?amount=10000Savings account rates: median, percentiles
GET /v1/market/mortgage-rates?amount=400000&period=25Mortgage APRC (RRSO), margin, nominal rate: median, percentiles
GET /v1/market/cash-loan-rates?amount=20000&period=48Cash loan APRC and nominal rate: median, percentiles

finwire indicators

EndpointReturns
GET /v1/finwire-indexAll finwire indices: id finwire_*, name, group, status, latest and previous reading with periods, change and its kind (pp, pct, abs), method version, sources, stale, pageUrl, methodologyUrl, citation
GET /v1/finwire-index/{id}?limit=120&from=2024-01One index by finwire_* id or alias, with history (limit 1-600, default 120; from YYYY-MM); requestedId echoes the id used
GET /v1/macro/nowcastFinwire Nowcast: next CPI and core inflation reading (point, 80% interval) and RPP decision probabilities, freeze date and status, settled history vs actual readings, backtest and live accuracy
GET /v1/macro/lead-forecasts?index=nplfinwire lead forecasts: NBP core inflation in 6 and 12 months (finwire_cost_pressure) and share of impaired (Stage 3) housing and consumer loans in 2 and 4 quarters (finwire_npl_forecast), 80% intervals, rolling backtest; numbers withheld (published: false) below 70% interval coverage
GET /v1/index/entry-thresholdGross monthly wage per person needed for a mortgage on a model flat (parameters in params) within KNF DSTI limits in 17 cities, the installment, and the share of employees earning at least that
GET /v1/index/entry-threshold/history?household=singleDaily change points per city, household: single or couple
GET /v1/index/credit-stressMortgage installment for a 50 m² flat as % of the average net wage in 16 provinces, with KNF Recommendation S DSTI thresholds
GET /v1/indexAll barometers with value, position against history and monthly change
GET /v1/index/{slug}One barometer with monthly series, methodology and best/worst month since 2015. slug: real-deposit-rate, housing-affordability, credit-cost, borrowing-power, purchasing-power
GET /v1/snapshotRates, inflation, FX, credit stress and barometers in one call

Full field-level schemas: openapi.json.

finwire indices (finwire_* ids)

Every index computed by finwire.pl has one stable id, the same in this API, in MCP, in CSV files on finwire.pl (column series_id) and in the page JSON-LD (identifier). Old dataset ids are accepted as aliases by /v1/finwire-index/{id}. The live list with readings: /v1/finwire-index; hub with charts: finwire.pl/indeksy.

idIndexGroupReadingAliases
finwire_mortgage_barometerBarometr kredytu hipotecznego finwirecreditdaily-
finwire_credit_capacity_indexIndeks zdolności kredytowej finwirecreditmonthly-
finwire_borrowing_power_barometer ¹Barometr zdolności kredytowej finwirecreditmonthlyborrowing-power
finwire_mortgage_cost_barometer ¹Barometr kosztu kredytu finwirecreditmonthlycredit-cost
finwire_rate_risk_gauge ¹Ryzyko raty finwirecreditdailyrate-risk
finwire_fixed_rate_premium ¹Premia za stałą stopę finwirecreditdailyrate-risk
finwire_credit_market_index ¹Wskaźnik rynku kredytów hipotecznych finwirecreditmonthlycredit-market-index, credit-market
finwire_npl_forecast ¹Stres kredytowy wyprzedzający finwirecreditmonthly (forecast)-
finwire_credit_stress_index ¹Mapa stresu kredytowego finwirecreditdailycredit-stress
finwire_deposit_rate_indexIndeks lokat finwiresavingsmonthlydeposit-rate-index, deposit_rate_index
finwire_savings_rate_indexIndeks kont oszczędnościowych finwiresavingsmonthly-
finwire_real_deposit_rate_barometerBarometr opłacalności lokat finwiresavingsmonthlyreal-deposit-rate
finwire_purchasing_power_barometerBarometr siły nabywczej złotówki finwiresavingsmonthlypurchasing-power
finwire_account_cost_indexKoszt konta osobistego wg finwiresavingsmonthly-
finwire_household_inflation_indexInflacja gospodarstw domowych finwiresavingsmonthly-
finwire_pension_wage_ratioEmerytura do płacy finwiresavingsmonthly-
finwire_fund_flows_indexIndeks napływów do funduszy finwiresavingsmonthly-
finwire_new_business_ratioWskaźnik nowych firm finwiremarketmonthly-
finwire_car_registrations_pulsePuls rejestracji aut finwiremarketmonthly-
finwire_chinese_brands_shareUdział marek z Chin finwiremarketmonthly-
finwire_ev_share_new_carsUdział elektryków w nowych autach finwiremarketyearly-
finwire_ev_charging_coverageNasycenie ładowarkami finwiremarketmonthly-
finwire_ev_charging_price_indexIndeks cen ładowania finwiremarketmonthly-
finwire_ev_charger_occupancyObłożenie ładowarek finwiremarketweekly (full week)-
finwire_ev_charger_reliabilitySprawność ładowarek finwiremarketdaily-
finwire_ev_fast_coverageZasięg ultraszybkich ładowarek finwiremarketdaily-
finwire_ev_infrastructure_growthPrzyrost ładowarek finwiremarketmonthly-
finwire_ppk_avg_accountŚrednie konto PPK finwiresavingsmonthly-
finwire_retail_bond_premiumPremia obligacji skarbowych finwiresavingsmonthly-
finwire_fixed_cost_burdenSztywne koszty gospodarstwa finwirehousingmonthly-
finwire_heating_season_indexIndeks chłodu sezonu finwirehousingdaily-
finwire_heating_season_costKoszt sezonu grzewczego finwirehousingdaily-
finwire_ike_ikze_avg_balanceŚrednie saldo IKE i IKZE finwiresavingshalf-yearly-
finwire_clean_air_payout_rateWskaźnik wypłat Czystego Powietrza finwirehousingweekly-
finwire_public_debt_per_capitaDług na osobę finwiremarketmonthly-
finwire_pit_per_capitaPIT na mieszkańca finwiremarketyearly-
finwire_rcn_price_indexIndeks cen transakcyjnych finwirehousingquarterly-
finwire_price_gap_indexIndeks luki cenowej finwirehousingquarterly-
finwire_entry_threshold_index ¹Próg wejścia finwirehousingdailyentry-threshold
finwire_housing_affordability_barometer ¹Barometr dostępności mieszkania finwirehousingmonthlyhousing-affordability
finwire_housing_carry ¹Carry nieruchomości finwirehousingmonthlyhousing-carry
finwire_housing_permits_indexIndeks pozwoleń na budowę finwirehousingmonthly-
finwire_housing_pressurePresja demograficzna na mieszkania finwirehousingyearly-
finwire_housing_pipelinePodaż mieszkań za 2 lata finwirehousingquarterly-
finwire_rent_forecastPrognoza czynszów finwirehousingmonthly-
finwire_offer_tickerTicker zmian ofert finwiremarketdailyoffer-changes
finwire_demand_indexIndeks popytu finwiremarketmonthly-
finwire_power_price_indexIndeks ceny prądu finwiremarketdaily-
finwire_shopping_basket_indexKoszyk zakupowy finwiremarketmonthly-
finwire_eu_power_price_gapLuka cen prądu Polska-UE finwiremarkethalf-yearly-
finwire_nowcastFinwire Nowcastmarketmonthlynowcast
finwire_cost_pressurePresja kosztowa finwiremarketmonthly (forecast)-
finwire_legal_calendarKalendarz zmian w finansach finwirelawdaily-
finwire_knf_warnings_monitorMonitor ostrzeżeń KNF finwirelawweeklyknf-warnings
finwire_bfg_guarantee_monitorLicznik instytucji z gwarancją BFG finwiresavingson every list changebfg-guarantee
finwire_tax_rulings_pulsePuls interpretacji podatkowych finwirelawweeklytax-rulings
finwire_borrower_win_shareWyroki dla kredytobiorców finwirelawmonthlycredit-judgments
finwire_next_year_limitsLimity na przyszły rok finwirelawdailynext-year-limits
finwire_local_tax_squeezeNożyce fiskalne gmin finwirehousingyearlylocal-tax-squeeze
finwire_gmina_spending_per_capitaWydatki gmin na mieszkańca finwiremarketyearlyjst-budget
finwire_average_polePrzeciętny Polak finwirecreditmonthlyaverage-pole
finwire_location_premiumPremia za okolicę finwirehousingquarterlylocation-premium

¹ Computed from WIBOR (GPW Benchmark): only the result is published, never WIBOR or POLSTR (usesBenchmarkRate: true).

License CC BY 4.0, attribution finwire.pl. Each index carries a ready citation with the id and method version, e.g.:

Source: Indeks zdolności kredytowej finwire (finwire_credit_capacity_index, method v1), finwire.pl, https://finwire.pl/indeksy/zdolnosc-kredytowa, CC BY 4.0

methodVersion changes with every change of the definition; history is recomputed or marked.


FAQ

Does the API return WIBOR or POLSTR?

No. WIBOR and POLSTR are administered by GPW Benchmark, and redistributing them requires a Market Data License Agreement with GPW ([email protected]). The API returns NBP policy rates: current values at /v1/series/interest-rate and daily history at /v1/series/interest-rate/{id}.

Where can I get Polish CPI inflation data as JSON?

/v1/series/cpi returns GUS consumer price inflation year-over-year and month-over-month, monthly since 1982 (type=monthly) or annually (type=yearly), with the GUS source in meta.

Is there an API for real estate transaction prices in Poland?

/v1/housing/transactions returns median, quartile and per-district flat prices per m² computed from notarial deeds in the Polish Real Estate Price Register (Rejestr Cen Nieruchomości) for 17 cities, with a quarterly trend for the last 12 quarters and a 12-month median per district. Single deeds are never exposed.

How much do I need to earn to buy a flat in a Polish city?

/v1/index/entry-threshold returns, for 17 Polish cities, the gross monthly wage one person needs to get a mortgage on a model 50 m² secondary-market flat (20% down payment, 25 years) within the KNF DSTI limits, the monthly installment and the share of employees who earn at least that. It is recomputed every night from prices per m² in notarial deeds (Real Estate Price Register, GUS RCiWN as a fallback for small samples), current mortgage offers and the GUS wage distribution; /history shows how it changed. Index id: finwire_entry_threshold_index.

How do I cite a finwire index?

Use the citation field of /v1/finwire-index/{id}: index name, finwire_* id, method version, finwire.pl and the page URL, CC BY 4.0. The id stays the same when the name or the method changes, so it is the safe key for your own database.

Is there an API for Polish tax and ZUS deadlines?

/v1/legal-calendar returns PIT, ZUS and VAT deadlines (moved to the next working day per art. 12 § 5 of the Tax Ordinance), the year end for IKE and IKZE contributions, changes of statutory values, acts entering into force, RPP meetings and retail bond sales. The same calendar is available as an ICS subscription at https://finwire.pl/kalendarz-zmian.ics.

Where can I get unemployment data by county (powiat)?

/v1/series/unemployment returns the GUS registered unemployment rate for Poland and the 16 provinces, /v1/series/unemployment/counties the counties with the lowest and highest rate, and /v1/series/unemployment/history the monthly series since 2011, all from the GUS Local Data Bank (BDL).

Is there an API for salaries by occupation in Poland?

/v1/wages/occupations returns mean, median and deciles of gross monthly wages for about 175 occupation groups from the GUS survey of wages by occupation (published every two years), split by gender and by public vs private sector, with the gender pay gap.

Do I need an API key or an account?

No key, token or sign-up is required. All endpoints are public, read-only (GET) and CORS-enabled, so they can be called directly from a browser.

Can I use the data commercially?

finwire indicators and aggregates are licensed under CC BY 4.0, which allows commercial use with attribution. Public data (NBP, GUS, Ministry of Finance, Eurostat, GPW Benchmark) requires attribution to the original source; meta.license states the terms per dataset.

How fresh is the data?

Each dataset is refreshed automatically from its primary source on the source's own schedule (daily for FX and rents, monthly for CPI and bond yields, quarterly for housing prices). meta.asOf always shows the date of the data at the source.

What is the difference between WIBOR and POLSTR?

WIBOR and POLSTR are both Polish interest rate benchmarks administered by GPW Benchmark. In the ongoing Polish benchmark reform supervised by KNF, POLSTR is the designated successor to WIBOR. Neither is available in this API (license required from GPW Benchmark).

Does the API give investment advice?

No. The data is informational. finwire.pl is not a licensed investment adviser and does not issue recommendations within the meaning of the EU Market Abuse Regulation (MAR).


Glossary

  • NBP reference rate - the main policy rate of Narodowy Bank Polski, set by the Monetary Policy Council (RPP).
  • WIBOR (Warsaw Interbank Offered Rate) - Polish interbank benchmark used for floating-rate loans.
  • POLSTR (Polish Short Term Rate) - GPW Benchmark interest rate index, WIBOR's successor in the benchmark reform.
  • CPI - consumer price index published monthly by GUS (Statistics Poland).
  • RCN (Rejestr Cen Nieruchomości) - Real Estate Price Register with prices from notarial deeds.
  • RRSO - Polish APRC (annual percentage rate of charge), the total cost of a loan.
  • DSTI - debt service to income ratio, the share of income spent on loan installments.
  • bps - basis points, 1 bps = 0.01 percentage point.
  • BDL (Bank Danych Lokalnych) - GUS Local Data Bank with statistics for provinces, counties and municipalities.
  • TERYT - official Polish territorial code of provinces, counties and municipalities.
  • Entry threshold (próg wejścia) - finwire indicator: the wage needed to qualify for a mortgage on a model flat.
  • finwire_* - stable id of an index computed by finwire.pl, the key in /v1/finwire-index, MCP and CSV series_id.
  • Property tax upper limit - the maximum local property tax rate set yearly by the Minister of Finance; municipalities choose their rate up to it.

OpenAPI specification and TypeScript types

This repository ships the OpenAPI specification and TypeScript types generated from it. Both are regenerated from the live API on every release.

ts
import type { paths } from './types/api';
type TransactionPrices =  paths['/v1/housing/transactions/{city}']['get']['responses']['200']['content']['application/json'];

Rate limits

  • 120 requests per minute per IP, 30 per minute for /v1/snapshot.
  • Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset; 429 comes with Retry-After.
  • Responses are cached at the edge (5 minutes to 1 hour depending on the dataset), so typical use never hits the limit.

Usage policy and disclaimer

  • Free and open, GET only. Please cache responses on your side.
  • Attribute the data with the meta.citation string or Source: finwire.pl, https://public-api.finwire.pl.
  • Single bank offers, notarial deeds and rental listings are never exposed - only statistics.
  • Informational data only, not investment advice (see FAQ).

Built by finwire.pl - Polish personal finance tools: mortgage decision tool, flat prices by city, deposit rankings.

来源:README.md,提交 26b2b8e

工具

62

get_macro_snapshot

Polish economy 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.

无需输入参数。

list_macro_indicators

List Polish macroeconomic indicators

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).

输入参数groupqueryinclude_descriptions

get_macro_indicator

One macro indicator with history

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".

输入参数key必填from

compare_macro_indicators

Compare indicators side by side

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.

输入参数fromkeys必填

get_macro_changes

What changed recently

Indicators whose reading was updated in the last N days (newest first), with the change against the previous reading.

输入参数days

get_macro_calendar

Upcoming macro releases

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.

输入参数limit

search_datasets

Find a dataset

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.

输入参数querycategory

get_dataset

Read any dataset

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.

输入参数id必填params

get_interest_rates

NBP interest rates

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).

输入参数daysrate

get_currency_rates

NBP exchange rates and gold

NBP mid, bid and ask rates of currencies against PLN (table), the history of one currency, or the NBP gold price (code "XAU").

输入参数codedays

get_fuel_prices

Maximum fuel prices

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.

输入参数history

get_retail_prices

Retail prices in shops (GUS)

Average retail prices of 30 goods and services in Poland from GUS (bread, butter, milk, eggs, meat, vegetables, sugar, electricity, gas, heating, petrol, diesel, bus ticket, taxi, haircut, doctor visit, cinema) for the latest month, with change vs the previous month and the same month a year earlier and the minutes of work each costs at the average net wage; plus the finwire shopping basket of 10 staple foods (finwire_shopping_basket_index).

输入参数product

get_pension_stats

Average ZUS pension and benefits

Average old-age pension paid by ZUS (gross and net), disability and survivor pensions, number of pensioners, sickness and maternity allowances, the pension to wage ratio finwire_pension_wage_ratio, CPI, minimum pension and indexations, monthly from preliminary ZUS data (without KRUS and uniformed services).

输入参数history

get_average_pole

Average Pole (typical person in Poland)

Profile of the typical person in Poland (finwire_average_pole) built from the latest official readings: median age (Eurostat), median gross and net wage (GUS), median price per m2 of a flat (GUS), average new mortgage (BIK), model monthly mortgage payment, average ZUS pension, spending per person (GUS household budgets), car age classes (Eurostat) and the most registered car brand. Each trait carries its measure (median, mean, model, distribution, most frequent) and its own data period.

无需输入参数。

get_investment_funds

Investment funds in Poland (IZFiA)

Assets, purchases of units, redemptions and net flows of investment funds in Poland from monthly IZFiA data: whole market, fund groups (short-term bond, bond, equity, mixed, PPK, target date, absolute return, commodity, crypto assets, private market) with IZFiA profiles, bond funds by type, equity funds by region, net flows since January and over 12 months, and the finwire index finwire_fund_flows_index (12-month net flows as % of assets a year earlier). Amounts in PLN million. Informational data, not investment advice.

输入参数history

get_business_registrations

New and closed businesses in Poland (CEIDG)

Monthly applications filed in CEIDG, the Polish register of sole proprietorships (Ministry of Development and Technology data on dane.gov.pl): registrations of new sole proprietorships, closures (deregistrations), suspensions and resumptions, registrations minus closures, the latest month against the same month in earlier years, the share of women among founders, sums since January and over 12 months, and the finwire index finwire_new_business_ratio (registration applications per 100 closure applications over 12 months; above 100 the number of firms grows). Counts of applications, not of firms in the register; companies registered in KRS are not included.

输入参数history

get_vehicle_registrations

Vehicle registrations in Poland (Ministry of Digital Affairs, CEPiK)

First registrations of vehicles in Poland, monthly since 2014, from the Ministry of Digital Affairs files with CEPiK data: passenger cars and all vehicles, 17 vehicle types, provinces per 1000 residents, top passenger-car brands of the month and of 12 months (nationwide or one province) and the share of brands from China by province, with the finwire indices finwire_car_registrations_pulse (12-month passenger cars, change year on year) and finwire_chinese_brands_share. A first registration in Poland covers new cars and used cars imported from abroad. Months with an inconsistent province or type split are held back and listed. For electric cars use get_electric_vehicles.

输入参数periodhistoryprovince

get_electric_vehicles

Electric cars in Poland (Eurostat, GUS, UDT)

Battery electric (BEV) and plug-in hybrid (PHEV) passenger cars in Poland: fleet at year end and new cars in the year with shares (Eurostat), fuel mix of new cars, provinces and counties per 1000 passenger cars with top and bottom counties (GUS BDL, when the county series is available), and the correlation of public charging sites per 10k residents with BEV per 1000 cars across counties, with a 95% interval and a version controlling the median wage. Correlation is not causation. Index finwire_ev_share_new_cars. For charging points use get_ev_charging.

输入参数counties

get_ev_charging

EV charging points in Poland (UDT EIPA)

Public EV charging in Poland from the UDT register EIPA: locations, stations and charging points today and at each month end since December 2019, growth year on year, charging sites and fast sites (at least 50 kW) by province and county, sites per 10k residents, sites by maximum power class (EU AFIR: up to 22 kW, 23-49, 50-149, 150-349, 350+ kW) and connector (CCS, Type 2, CHAdeMO), counties with the most ultra-fast sites (150 kW and more), networks with the most fast sites, the finwire index finwire_ev_charging_coverage (charging points per 1000 BEV and PHEV cars in the fleet), growth records and the finwire index finwire_ev_infrastructure_growth (charging points year on year), and daily growth by power class and network since the start of measurement. Interactive map with every site: finwire.pl/mapa-ladowarek.

输入参数history

find_ev_chargers

Find EV chargers in Poland (UDT EIPA)

Public EV charging sites in Poland from the UDT register EIPA near a city or a point: give city, or lat and lon with radius_km. Filters: min_kw (e.g. 150 for ultra-fast), free_charging, available_now (at least one point free according to a status younger than 2 hours), network slug, connector (ccs, chademo, type2). Each site: name, address, network, power class (AFIR), maximum kW, points, points free now, lowest ad hoc price per kWh (price for a driver without a contract), distance. Pass id for one site with stations, points, connectors, prices and status. Operators report data; check the price at the charger.

输入参数idlatloncitylimitmin_kwnetworkconnectorradius_kmavailable_nowfree_charging

get_ev_charging_prices

EV charging prices in Poland (UDT EIPA)

Ad hoc EV charging prices in Poland (for a driver without a contract) reported by operators to the UDT register EIPA: median price per kWh with point counts by power class (AC up to 22 kW, DC below 50 kW, DC 50-149 kW, from 150 kW), AC vs DC, cheapest and most expensive networks, share of points with a per-minute fee, recent price changes and the finwire index finwire_ev_charging_price_index. With network: that network's price list by power class and its price changes. Subscriptions and app tariffs can be cheaper and are not included.

输入参数network

get_ike_ikze_stats

IKE and IKZE retirement accounts in Poland (KNF)

IKE and IKZE (Polish individual retirement accounts with tax relief) from half-yearly KNF data: number of accounts and assets, split by institution type (insurers, investment funds, brokers, banks, voluntary pension funds), accounts opened, contributions, withdrawals and returns since January, holders by sex and age, average annual contribution as % of the statutory annual limit (December states), and the finwire index finwire_ike_ikze_avg_balance (average balance per account). Amounts in PLN. For the contribution limits themselves use get_legal_limits. Informational data, not investment advice.

输入参数history

get_subsidy_stats

Czyste Powietrze subsidy programme statistics

Czyste Powietrze (Clean Air), the Polish subsidy programme for replacing heating sources and thermal modernisation of single-family houses, from the weekly NFOŚiGW summary: applications, contracts and paid subsidies cumulative (all editions and the Modernisation Fund edition), last week, completed contracts, bank loan grants, requested heat sources by type, the payout queue (contracted but not yet paid) with weekly pace, and finwire_clean_air_payout_rate (paid as % of contracted). National data only.

输入参数history

get_retail_bond_premium

Polish retail savings bonds vs bank deposits

Premia obligacji skarbowych finwire (finwire_retail_bond_premium): by how much the first-year rate of Polish State Treasury retail savings bonds (OTS, ROR, DOR, TOS, COI, EDO; family ROS and ROD separately) exceeds the finwire deposit index (best 3-month deposits), the finwire savings account index and the average new household term deposit (NBP MIR), after the 19% capital gains tax on both sides, in percentage points; monthly retail bond debt change (Ministry of Finance), household term deposits change (NBP) and a sales response test on our own series. Describes the rate gap only, not investment advice.

输入参数history

get_fixed_cost_burden

Household fixed cost burden by province

Sztywne koszty gospodarstwa finwire (finwire_fixed_cost_burden): share of net income of a model household (two earners on the regional median wage) taken by the mortgage payment on a 50 m2 flat in the province capital, administrative fee, heating, water, waste, electricity and TV licence; Poland and 16 provinces, monthly, with the share without the mortgage.

输入参数regionhistory

get_municipal_budget

Budget of a Polish municipality: spending, debt, EU funds

Pieniądze Twojej gminy (finwire_gmina_spending_per_capita): for one Polish municipality (gmina) or city with county rights - executed spending per resident by category (schools, social help, family benefits and nurseries, roads, waste and water, administration, culture, sport, municipal housing, fire brigades, interest on debt) vs neighbouring municipalities, municipalities of similar type and size and Poland (Ministry of Finance Rb-28S, last full year and current year to date), investment share, debt per resident at the end of the latest quarter (Rb-Z), EU funding per resident 2021-2027 and 2014-2020 with the largest projects (only projects located in one municipality; natural persons are not named). Without a municipality: national figures; with metric: ranking.

输入参数familymetricmunicipality

get_heating_season

Heating season in Poland: degree days, cold index, season cost

Indeks chłodu sezonu finwire (finwire_heating_season_index) and Koszt sezonu grzewczego finwire (finwire_heating_season_cost): heating degree days since 1 July (Eurostat method, IMGW-PIB synoptic stations) vs the 20-season norm for Poland and 17 cities, cold index (100 = norm, below = warmer), season forecast with an 80% interval only when the backtest gate passes (otherwise the reason), season heating cost of a 100 m2 house (gas, heat pump, coal, district heating), monthly means vs norm, coldest and warmest seasons since 1966/67.

输入参数city

get_ppk_stats

PPK (Employee Capital Plans) statistics

PPK (Pracownicze Plany Kapitałowe), the Polish auto-enrolment workplace pension programme, from the monthly PFR Portal PPK bulletin (PPK Register kept by PFR): net assets of target date funds, active accounts, participants, employers running PPK, participation rate, average management fee, number of financial institutions and finwire_ppk_avg_account (Średnie konto PPK finwire: net assets per active account), with monthly history.

输入参数history

get_public_debt

Polish public debt and state budget

State Treasury debt of Poland at the end of the latest month (Ministry of Finance): amount, change, debt per resident finwire_public_debt_per_capita, average growth per second over 12 months, domestic/foreign and retail bonds; national public debt and general government debt % of GDP (quarterly); state budget deficit cumulative from January with the plan from the budget act and the same period a year earlier.

输入参数history

list_finwire_indices

finwire index registry

All indices computed by finwire.pl, each under a stable id finwire_* (e.g. finwire_mortgage_barometer, finwire_credit_capacity_index, finwire_deposit_rate_index, finwire_savings_rate_index, finwire_rcn_price_index, finwire_price_gap_index, finwire_entry_threshold_index, finwire_credit_market_index, finwire_nowcast, finwire_legal_calendar): latest reading with its period, change vs the previous reading, method version and citation. Use get_finwire_index for one index with history.

输入参数groupstatus

get_finwire_index

One finwire index with history

One finwire index by its id finwire_* (old dataset ids such as credit-market-index, borrowing-power or credit-stress are accepted as aliases): latest and previous reading with periods, change, method version, sources, citation formula and history. Indices computed from WIBOR publish only the result.

输入参数id必填history

get_nowcast

Finwire Nowcast: inflation and RPP forecasts

Finwire Nowcast (finwire id: 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.

输入参数historyindicator

get_lead_forecasts

finwire lead forecasts: core inflation and impaired loans

Two finwire.pl models with 80% intervals. finwire_cost_pressure (Presja kosztowa finwire): NBP core inflation y/y in 6 and 12 months from a unit labour cost proxy, producer prices and the EUR/PLN change. finwire_npl_forecast (Stres kredytowy wyprzedzający finwire): share of impaired (IFRS 9 Stage 3, KNF) housing and consumer loans in 2 and 4 quarters from the WIBOR 3M change, unemployment and the portfolio trend. A forecast is shown only when at least 70% of actual readings fell inside the 80% interval in the rolling backtest; otherwise published is false and only the accuracy statistics are given. A model estimate, not investment advice.

输入参数index

get_energy_prices

Regulated electricity and gas prices

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.

输入参数areadatecarrier

get_broker_fees

Brokerage account fees

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.

输入参数brokermarket

get_housing_prices

Flat prices per m² (notarial deeds)

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. view "location-premium" gives finwire_location_premium: per district, how far the actual price deviates from the price expected from neighbourhood quality (transport, schools, shops, greenery, quiet, air), with model fit and accuracy; without city, the status of every city. The quarterly finwire indices finwire_rcn_price_index and finwire_price_gap_index: get_finwire_index.

输入参数cityviewsourcedistrict

get_rents

Rents and rental yield

Asking rents (median, per m², month-over-month change) in Polish cities and districts, with gross and net rental yield and payback period.

输入参数city

get_housing_carry

Housing carry: rent vs mortgage interest per city

Carry nieruchomości finwire (finwire_housing_carry): per Polish city, the net rental yield of a typical 2-room flat (after one vacant month, flat-rate rental tax, admin fee in vacant months and property tax) minus the variable mortgage interest rate, in percentage points, monthly with history, plus net rent minus first-year interest in PLN per month for a loan covering the whole price. Negative carry = interest exceeds net rent; buying to let on credit then relies on price growth. For rents and plain yields use get_rents. Informational data, not investment advice.

输入参数city

get_housing_balance

Housing demand vs supply and forecasts (finwire)

finwire housing balance for Poland and 17 cities: finwire_housing_pressure (new residents per 1 dwelling completed in the same year, from GUS migration for permanent residence and foreigners insured in ZUS, yearly), finwire_housing_pipeline (forecast of dwellings completed in 4 quarters up to 2 years ahead from GUNB building permits, 80% interval and backtest accuracy per horizon) and finwire_rent_forecast (6-month change of asking rent per m2, published only after passing the accuracy threshold). Present forecasts as model estimates with the interval and accuracy, never as certainty.

输入参数city

get_housing_costs

Running costs of a flat

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).

输入参数city

get_credit_market

Housing loan market

Polish housing loan market: topic "index" (finwire 0-100 credit market index, returns finwire_credit_market_index), "survey" (NBP bank lending survey: criteria and demand), "monetary" (NBP household loans and deposits, new housing loans), "demand" (BIK Demand Index for housing loans, average requested vs granted amount, granted loans y/y according to BIK, new housing loans from NBP).

输入参数topic

get_rate_risk

Mortgage payment risk and fixed-rate premium

finwire model on WIBOR fixings and bank offers: finwire_rate_risk_gauge (Ryzyko raty finwire) - chance that the payment of a PLN 400,000, 30-year variable-rate mortgage rises by more than 5% or 10% (or falls by more than 5%) in 3, 6 and 12 months, with the 10th/50th/90th percentile of the payment and backtest accuracy since 2008 (80% interval coverage); finwire_fixed_rate_premium (Premia za stałą stopę finwire) - the typical 5-year fixed rate minus the expected cost of the variable rate over 5 years, in pp, daily and monthly (ECB MIR), with windows of a negative premium. A model estimate, not a certainty and not advice.

输入参数history

get_bank_rates

Market rates: loans, deposits, bonds

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"). finwire indices of the best offers (finwire_mortgage_barometer, finwire_deposit_rate_index, finwire_savings_rate_index, finwire_account_cost_index): get_finwire_index.

输入参数amountperiodproduct必填

get_next_year_limits

Next-year statutory limits from legal formulas

Statutory values for the next year computed by finwire.pl from the formulas in Polish law on the latest GUS and NBP data, before the official act (finwire_next_year_limits): pension indexation and minimum pension, minimum wage and hourly rate (statutory minimum rise), projected average wage, IKE and IKZE limits, the 30x ZUS cap, ZUS contribution bases, flat-rate tax and small CIT taxpayer limits. Each item: value, 80% interval, stage (projekcja = estimate, projekt, obwieszczenie = announced, obowiazuje = in force), calculation and backtest accuracy. Present estimates as estimates; for values in force this year use get_legal_limits.

输入参数key

check_knf_warnings

Check a firm on the KNF warnings list

Look up a company, investment platform or website on the public warnings list of the Polish Financial Supervision Authority (KNF) by name, website domain, KRS, NIP or REGON. Returns matching entries verbatim from KNF (entity, identifiers, legal basis, prosecutor, final rulings, important information). An entry is a notification of a suspected offence, not a conviction; no match does NOT mean the firm is licensed or safe. Without query: list size, entries by legal basis, entries new this week and the weekly series finwire_knf_warnings_monitor.

输入参数limitquery

check_bfg_guarantee

Check the BFG deposit guarantee of a bank

Check whether a Polish bank or credit union (SKOK) is on the list of entities covered by the deposit guarantee of the Bankowy Fundusz Gwarancyjny (BFG), by name, trade name (e.g. "Inteligo") or website. Without query: counts of commercial banks, cooperative banks, credit unions and entities in bankruptcy (series finwire_bfg_guarantee_monitor) with history and latest changes, and the guarantee limit (EUR 100,000 per depositor per bank) with its PLN equivalent at the latest NBP rate. Branches of banks from other EU countries are covered by their home-country scheme, so no match for them is expected.

输入参数limitquery

get_tax_rulings

Tax rulings on personal finance

Individual tax rulings of the Polish tax information office (KIS) and municipal rulings on property tax, published in the EUREKA database of the Ministry of Finance, by topic: private rental (najem_prywatny), selling a flat and the housing relief (sprzedaz_nieruchomosci), IKE/IKZE (ike_ikze), crypto (kryptowaluty), shares, funds and dividends (inwestycje_pit38), sole proprietorship, lump-sum tax and IP Box (jdg_ryczalt), PIT reliefs (ulgi_pit), property tax (podatek_od_nieruchomosci). Returns counts per full week (series finwire_tax_rulings_pulse), provisions cited most often in the last 52 weeks and the newest rulings with signature, authority, dates, shortened thesis and a link to the full text. A ruling answers one taxpayer about their own case; it is not legal advice.

输入参数limittopic

get_credit_judgments

Court rulings in credit disputes

Statistics of rulings of Polish common courts in consumer credit disputes, published in the Court Rulings Portal of the Ministry of Justice and classified by finwire.pl: CHF mortgages (chf), loans in EUR and other currencies (waluta_inna), free credit sanction under art. 45 of the Consumer Credit Act (skd), cost refunds after early repayment, Lexitor (wczesniejsza_splata), WIBOR clauses (wibor), unit-linked policies (polisolokata). Returns rulings per publication month, share ruled for the borrower at least in part in 12 full publication months (finwire_borrower_win_share, total and per category), first vs second instance, median time from claim to judgment and the newest rulings with case number, court, outcome and a link to the full text. Statistics of published rulings, not legal advice; each ruling concerns one contract.

输入参数limitcategory

get_regional_data

Regional data: income, unemployment, wages

Regional data: "income" (residents income per capita by municipality, or county with level "powiat"), "pit" (PIT due per resident from tax returns by municipality and province, by type of return, PIT-38 capital gains returns per 1000 residents, finwire_pit_per_capita; with name = one municipality year by year), "local-tax" (finwire_local_tax_squeeze: property tax as % of property tax + PIT share in municipal budget plans, provinces, cities, municipalities in the squeeze, upper limit of the property tax rate for flats; with name = matching municipalities), "unemployment" (registered unemployment by province), "wages" (average wage by province). Filter by name.

输入参数nameyearlevellimittopic必填

get_europe_data

Poland against Europe

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), "energy-prices" (household electricity or gas prices per kWh in EUR and purchasing power standards, half-yearly, with finwire_eu_power_price_gap and kWh per minimum wage), "minimum-wages" (statutory minimum wages in EUR and PPS, half-yearly).

输入参数topic必填compareproduct

calc_net_income

Take-home pay in Poland for any form of work

Monthly take-home pay in Poland from: employment contract (uop: umowa o pracę, standard costs, PIT-2 filed, no reliefs), mandate contract (zlecenie: ZUS, health, 20% costs, PIT-2), contract for specific work (dzielo: no ZUS, 20% costs) or B2B self-employment of a sole proprietor (b2b: tax scale, flat 19% tax or lump-sum ryczałt on revenue, chosen ZUS scheme). Returns social security (ZUS), health contribution, income tax, net, yearly totals, effective rate and, for uop and zlecenie, the cost to the payer. Rates of the Polish tax year, switching on 1 January. For one person choosing between business forms use compare_business_forms.

输入参数ppktaxzusform必填yearlump_sum_ratemonthly_costsmonthly_amount必填student_under_26

calc_employer_cost

Cost of hiring an employee in Poland

Total monthly cost to the employer of an employment contract (umowa o pracę) or a mandate contract (umowa zlecenie) in Poland for a given gross pay: employer pension and disability contributions, accident insurance (basic rate for payers up to 9 insured), Labour Fund (FP), Guaranteed Employee Benefits Fund (FGŚP), optional PPK, plus what the employee takes home. Rates of the Polish tax year.

输入参数ppkyearcontractmonthly_gross必填

compare_business_forms

Sole proprietorship vs limited company in Poland

Compare yearly taxes and net income to the owner for running a business in Poland as a sole proprietorship (JDG: tax scale, flat 19% tax, lump-sum ryczałt) or a limited liability company (sp. z o.o.) with one shareholder (shareholder pays ZUS and the health contribution) or with two or more shareholders. Company profit taxed with CIT (9% small taxpayer when revenue fits the EUR limit at the NBP rate set by law, otherwise 19%) and the dividend tax: Polish statutory rate by default, or pass dividend_tax_rate from a tax treaty for a shareholder resident abroad. Assumes all profit is paid out as dividend. Not covered here: who may open which form (residence status), management board pay, Estonian CIT.

输入参数zusyearyearly_costslump_sum_rateyearly_revenue必填dividend_tax_rate

calc_zus_contributions

Social security (ZUS) of a sole proprietor in Poland

Monthly social security contributions (ZUS: pension, disability, sickness, accident, Labour Fund) of a sole proprietor (JDG) in Poland under each scheme: start relief (ulga na start), preferential ZUS and full ZUS, with the contribution base. The health contribution depends on the tax form and income; use calc_net_income with form b2b for it.

输入参数year

plan_business_entry

Plan entering Poland with a business

One call for someone from abroad starting a business in Poland: every legal form with available yes/no and the reason for their residence status, yearly taxes and net income to the owner for each available form (dividend tax at the tax-treaty rate of the owner country), setup steps, residence and identity requirements, and the deadline calendar for the best option. Facts carry the act, article, link and verification date.

输入参数langyearemployeesvat_payerowner_status必填yearly_costslump_sum_rateowner_countryyearly_revenue必填

get_business_forms

Business forms a foreigner may use in Poland

All Polish business forms (sole proprietorship JDG, unregistered activity, sp. z o.o., P.S.A., S.A., general, limited and professional partnerships, branch, representative office) with available yes/no for the owner status, the reason, conditions (e.g. PESEL for CEIDG) and facts on capital, liability, registration and tax, each with the legal basis.

输入参数langowner_status必填

get_tax_treaty

Tax on profit paid from Poland to another country

Polish withholding tax on dividends, interest and royalties paid to a resident of a country: the statutory rate, the rate in the double tax treaty with Poland (portfolio and qualified holding), whether MLI modifies the treaty, and the EU/EEA/Swiss parent-subsidiary exemption with its holding conditions. Covers the largest investor countries by NBP data; without country returns the list and the ranking.

输入参数langcountry

get_compliance_calendar

Yearly deadlines of a business in Poland

Calendar of tax, ZUS, VAT, payroll and reporting deadlines for a calendar year: monthly PIT/CIT advances or ryczałt, own ZUS, JPK_V7M, PIT and ZUS of employees, PPK, annual returns, annual health contribution, CIT-8, financial statements and JPK files. Dates are computed from statutory rules with the shift to the next working day; event-based duties (CRBR, ZUS registration, invoices) are listed as facts.

输入参数form必填langyearemployeesvat_payer

get_business_guide

Rules of doing business in Poland, with sources

Verified facts about doing business in Poland, each with the act, article, link to the official text and the verification date. Topics: intl-tax (selling into Poland from abroad, VAT registration, reverse charge, OSS, permanent establishment, transfer pricing, Estonian CIT, IP Box), residence (permits, MOS), identity (PESEL, NIP, trusted profile, e-signature), documents (sworn translation, apostille), forms, setup (steps and deadlines), activity (PKD 2025, regulated activities), wht, treaty, tax-residence, health (NFZ, A1), property (buying property as a foreigner), contracts, labour (Labour Code rules), hiring-foreigners (work permits, declarations), deadlines, accounting (books, invoices, KSeF, whitelist), incentives (Polish Investment Zone, regional aid map, R&D relief), exit (suspension, conversion, liquidation). Pass a topic, a query, or both.

输入参数langquerytopic

get_business_glossary

Polish business terms in English

Polish-English glossary of business, tax, ZUS and registration terms (JDG, sp. z o.o., CEIDG, KRS, ryczałt, KPiR, KSeF, JPK, CRBR, UPO, PSI and others) with one-line explanations.

输入参数lang

版本历史

8
  1. v1.14.0最新Nov 7, 2026
  2. v1.10.0Nov 6, 2026
  3. v1.9.1Nov 5, 2026
  4. v1.8.0Nov 5, 2026
  5. v1.7.0Nov 4, 2026
  6. v1.6.0Nov 3, 2026
  7. v1.5.0Nov 3, 2026
  8. v1.3.0Oct 30, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。